• Home
  • Random
  • Nearby
  • Log in
  • Settings
Donate Now If Wikipedia is useful to you, please give today.
  • About Wikipedia
  • Disclaimers
Wikipedia

Template:Single chart

  • Template
  • Talk
  • Language
  • Watch
  • View source
Template documentation[view] [edit] [history] [purge]
WarningThis template is used on approximately 42,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.
This template uses Lua:
  • Module:Music chart (sandbox)

This template cites sources for singles. Related: {{Album chart}}, {{Year-end single chart}}.

The template produces a table row with chart name, reference, and peak position for inclusion within a table. It does not create surrounding table markup.

This template does not verify positions. It provides a reference URL believed to be associated with a reliable source. The reference URL itself is not checked — incorrect spellings can produce bad links. Individual editors will need to follow the URLs generated by the template to verify their usefulness before walking away from an edited article.

Usage

This template outputs data suitable for inclusion within a record chart table. It will produce a referenced chart name and a position. It can be used as a part of a larger table, or a series of cells can be used to create a chart. This template does not create the surrounding table markup.

All field names used must be in lowercase. You can copy a blank version to use. Remember to use the "|" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.

Template syntax
Full version (copy and paste text below and delete parameters you don't need)
{{Single chart |(Chart identifier) |(Peak position) |artist= |artistid= |song= |songid= |chartid= |url= |date= |year= |week= |note= |publish-date= |access-date= |refname= |refgroup= |rowheader= }}

It is a good practice to always include song and artist, even though some uses of the template do not require them. This makes it easier to modify the template in the future if there is a change in the archives referenced by the template. In addition, the artist parameter is used by default to name references for reuse elsewhere in the article.

rowheader defaults to false. If set to true, the chart name will be output as a header, as indicated by WP:ACCESS#Data tables. In most cases, it should be true.

Output

The template produces:

  • A table row: left cell with chart name (with wikilinks) and reference, right cell with centered position
  • A reference for reuse elsewhere (named automatically in standard mode; in manual mode, use refname= to reuse it)

Example

{{Single chart|Australia|1|artist=Beyoncé|song=Halo|access-date=January 1, 2025|rowheader=true}}

Produces:

Australia (ARIA)[1] 1
  1. ↑ "Example – Example". ARIA Top 50 Singles.

Reference naming

References are auto-named in format sc_{ChartID}_{artist}. To reuse:

...some fact.<ref name="sc_Australia_Beyoncé"/>

Override with refname=customname. Note: if refname contains spaces, you must use quotes: <ref name="custom name"/>.

In manual mode, references are anonymous by default unless refname= is set.

Parameters

ParameterDescription
1Required. Chart identifier. Must match one of the supported charts. Often named as country (e.g., Australia) or specific chart (e.g., Billboardhot100). Some charts have aliases producing identical results.
2Required. Peak position. If song hasn't charted, use en-dash (–), not hyphen (-). Usually better to omit the template entirely.
artistArtist name as listed on chart. Odd spellings (e.g., Ke$ha) and stylizations can be tricky. German charts typically require lastname,firstname format. Always preview the resulting URL. Also used for default reference naming.
songSong title. Made-up words, slang, tricky punctuation can produce bad URLs — always preview.
artistidNumeric artist identifier from chart website URL. Example: Madonna at officialcharts.com has URL .../artist/28948/madonna/, so artistid=28948.
songidNumeric song identifier from chart website URL. Example: "In My Mind" at tophit.com has URL tophit.com/tracks/88003, so songid=88003.
chartid, idNumeric chart/archive identifier from URL. Example: Poland ZPAV chart has URL zpav.pl/rankingi/listy/nielsen/top5.php?lang=2&idlisty=532, so chartid=532.
yearFour-digit year indicating the year being reported by the chart. Used in combination with week for some charts. Must be exactly 4 digits.
weekWeek number (1–53) indicating the week being reported by the chart. Used in combination with year. Can be 1–2 digits (e.g., 1 or 03) or combined format like 51+52.
dateDate of the chart in the format YYYYMMDD or another format specified, indicating year (Y), month (M) and day (D). Used solely to create the reference URL, not displayed in references. For display date, use publish-date.
urlUser-provided URL for charts without automatic indexing. Some charts validate URL for required domain.
publish-datePublication date of the chart (free-format, for display in reference). Not the same as date which is used for URL construction.
access-dateDate when source was verified by editor.
archive-urlURL of archived version of the source.
archive-dateDate when the source was archived.
rowheaderSet to true to output chart name as row header per MOS:DTAB. Should be true in most cases.
refnameCustom reference name. Default: sc_{Chart}_{artist}. Names with spaces require quotes in <ref name="..."/>.
refgroupReference group name.
noteNote displayed after chart name (e.g., note=remix version, note=deluxe edition). Useful for distinguishing versions or noting renamed charts.

Chart-specific parameters

ParameterDescription
pagePage number for book sources. Used only with AustraliaKent ({{cite Kent}}).

Examples

Since this template produces only individual rows within a table, you will need to add (or already have) the table's framework in the article. Here is a sample table. For more on table formatting, see WP:TAB.

{| class="wikitable sortable plainrowheaders"
|+Chart performance for "Example Song"
! scope="col"| Chart (2024)
! scope="col"| Peak<br>position
|-
{{Single chart|Australia|6|song=Example Song|artist=Example Artist|rowheader=true}}
|-
! scope="row"| [[Billboard Brasil|Brazil ''Billboard'' Hot 100]]<ref>"Brazil Hot 100". ''Billboard Brasil''. November 2024.</ref>
| style="text-align:center;"| 1
|-
{{Single chart|Austria|3|artist=Example Artist|song=Example Song|note=remix version|rowheader=true}}
|-
{{Single chart|UK|3|date=20240115|rowheader=true}}
|}

Expands into:

Chart performance for "Example Song"
Chart (2024) Peak
position
Australia (ARIA)[1] 6
Brazil Billboard Hot 100[2] 1
Austria (Ö3 Austria Top 40)[3]
remix version
3
UK Singles (OCC)[4] 3
  1. ↑ "Example Artist – Example Song". ARIA Top 50 Singles.
  2. ↑ "Brazil Hot 100". Billboard Brasil. November 2024.
  3. ↑ "Example Artist – Example Song" (in German). Ö3 Austria Top 40.
  4. ↑ "Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.

Manual reference mode

Use when:

  • Song name contains special characters producing URL errors
  • Using alternative reliable source (Billboard Chart Beat, Allmusic, etc.)

To activate manual referencing, write M as the third parameter, after the chart identifier and position:

Template syntax for manual reference mode
Full version (copy and paste text below and delete parameters you don't need)
{{Single chart |(Chart identifier) |(Peak position) |M |url= |title= |work= |publisher= |location= |date= |archive-url= |archive-date= |url-status= |access-date= |refname= |refgroup= |rowheader= |note= }}

When manual referencing is activated, you must provide url and title, and may additionally provide work, publisher, location, date, access-date, archive-url, archive-date, url-status, refname, refgroup, rowheader, and note.

When |3=M is set, manual mode takes full priority — chart-specific parameters are not used for automatic URL generation, and references are anonymous by default unless refname= is provided.

Supported charts

Different charts require different parameters depending on their archive systems. Always preview the resulting URL before saving.

The table below is auto-generated from JSON data and lists all currently supported charts. New charts can be added to the JSON data, but avoid adding deprecated charts. For details on adding charts, see module documentation; a brief schema reference is at the top of single.json.

Data: Module:Music chart/single.json • Testcases: Template:Single chart/testcases

Single chart outputs
GroupChart IDUsesChartProviderRequired paramsTemplate callSample ref outputNotes
ArgentinaArgentina15 → Billboardargentinahot100
Argentina Anglo50Argentina Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Argentina Anglo|0|date=}}"Top 20 Argentina Anglo música". Monitor Latino.Data from June 6, 2016.
Argentina ML30Argentina AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Argentina ML|0|date=}}"Top 20 Argentina música". Monitor Latino.
Billboardargentinahot100485Argentina Hot 100Billboardartist{{Single chart|Billboardargentinahot100|0|artist=}}"{artist} Chart History (Argentina Hot 100)". Billboard.
AustraliaAustralia6983AustraliaARIAartist, song{{Single chart|Australia|0|artist=|song=}}"{artist} – {song}". ARIA Top 50 Singles.
AustraliaKent25AustraliaKent Music Reportpage{{Single chart|AustraliaKent|0|page=}}{{cite Kent|page=42}}.
Australiadance155Australian DanceARIAurl{{Single chart|Australiadance|0|url=}}"[{url} The ARIA Report, Issue ]". ARIA Top 50 Dance Singles. National Library of Australia.
Australiapandora429AustraliaARIAurl{{Single chart|Australiapandora|0|url=}}"[{url} The ARIA Report, Issue ]". ARIA Top 100 Singles. National Library of Australia.
Australiaurban527Australian UrbanARIAurl{{Single chart|Australiaurban|0|url=}}"[{url} The ARIA Report, Issue ]". ARIA Top 40 Urban Singles. National Library of Australia.
AustriaAustria6727AustriaÖ3 Austria Top 40artist, song{{Single chart|Austria|0|artist=|song=}}"{artist} – {song}" (in German). Ö3 Austria Top 40.
BelarusBelarus93Belarus AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Belarus|0|date=}}"Top Radio Hits Belarus Weekly Chart". TopHit.
BelgiumFlanders7048BelgiumUltratop 50 Flandersartist, song{{Single chart|Flanders|0|artist=|song=}}"{artist} – {song}" (in Dutch). Ultratop 50.
Flanders Dance281Belgium DanceUltratop Flandersartist, song{{Single chart|Flanders Dance|0|artist=|song=}}"{artist} – {song}" (in Dutch). Ultratop Dance.
Flanders Tip3258BelgiumUltratip Bubbling Under Flandersartist, song{{Single chart|Flanders Tip|0|artist=|song=}}"{artist} – {song}" (in Dutch). Ultratip.
Flanders Urban204Belgium UrbanUltratop Flandersartist, song{{Single chart|Flanders Urban|0|artist=|song=}}"{artist} – {song}" (in Dutch). Ultratop Urban.
Wallonia3949BelgiumUltratop 50 Walloniaartist, song{{Single chart|Wallonia|0|artist=|song=}}"{artist} – {song}" (in French). Ultratop 50.
Wallonia Dance167Belgium DanceUltratop Walloniaartist, song{{Single chart|Wallonia Dance|0|artist=|song=}}"{artist} – {song}" (in French). Ultratop Dance.
Wallonia Tip2402BelgiumUltratip Bubbling Under Walloniaartist, song{{Single chart|Wallonia Tip|0|artist=|song=}}"{artist} – {song}" (in French). Ultratip.
BoliviaBolivia31Bolivia AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Bolivia|0|date=}}"Top 20 Bolivia música". Monitor Latino.Data from August 21, 2017.
Bolivia Anglo57Bolivia Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Bolivia Anglo|0|date=}}"Top 20 Bolivia Anglo música". Monitor Latino.
BrazilBrazil (defunct)28Brazil Hot 100 AirplayBillboard Brasil—{{Single chart|Brazil|0}}(no url)
Brazil2167Brazil Hot 100Billboardartist{{Single chart|Brazil2|0|artist=}}"{artist} Chart History (Brasil Hot 100)". Billboard.Data from September 2, 2023.
BulgariaBulgaria45Bulgaria AirplayBAMPurl{{Single chart|Bulgaria|0|url=}}"[{url} Airplay Top 5 – ]". Bulgarian Association of Music Producers.
CISCIS1461CIS AirplayTopHitsongid{{Single chart|CIS|0|songid=}}"Charts – TopHit – Highway to Airplay". TopHit.
CanadaBillboardcanadaac (defunct)735Canada ACBillboardartist{{Single chart|Billboardcanadaac|0|artist=}}"{artist} Chart History (Canada AC)". Billboard. {{dead link|date=November 2024}}
Billboardcanadachrtop40 (defunct)1257Canada CHR/Top 40Billboardartist{{Single chart|Billboardcanadachrtop40|0|artist=}}"{artist} Chart History (Canada CHR/Top 40)". Billboard. {{dead link|date=November 2024}}
Billboardcanadacountry1302Canada CountryBillboardartist{{Single chart|Billboardcanadacountry|0|artist=}}"{artist} Chart History (Canada Country)". Billboard.
Billboardcanadahotac (defunct)1108Canada Hot ACBillboardartist{{Single chart|Billboardcanadahotac|0|artist=}}"{artist} Chart History (Canada Hot AC)". Billboard. {{dead link|date=November 2024}}
Billboardcanadarock (defunct)730Canada RockBillboardartist{{Single chart|Billboardcanadarock|0|artist=}}"{artist} Chart History (Canada Rock)". Billboard. {{dead link|date=November 2024}}
Billboardcanadianhot100733Canada Hot 100Billboardartist{{Single chart|Billboardcanadianhot100|0|artist=}}"{artist} Chart History (Canadian Hot 100)". Billboard.
Canada5578 → Billboardcanadianhot100
Canadaadultcontemporary1365Canada Adult ContemporaryRPMchartid{{Single chart|Canadaadultcontemporary|0|chartid=}}"Top RPM Adult Contemporary: Image 12345". RPM. Library and Archives Canada.After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Canadacountry1808Canada Country TracksRPMchartid{{Single chart|Canadacountry|0|chartid=}}"Top RPM Country Tracks: Image 12345". RPM. Library and Archives Canada.
Canadadance573Canada Dance/UrbanRPMchartid{{Single chart|Canadadance|0|chartid=}}"Top RPM Dance/Urban: Image 12345". RPM. Library and Archives Canada.
Canadamainstreamrock34Canada Mainstream RockBillboard Canadadate [YYYY-MM-DD]{{Single chart|Canadamainstreamrock|0|date=}}"Canada Mainstream Rock for the week of January 15, 2024". Billboard Canada.Data from February 1, 2025.
Canadamodernrock41Canada Modern RockBillboard Canadadate [YYYY-MM-DD]{{Single chart|Canadamodernrock|0|date=}}"Canada Modern Rock for the week of January 15, 2024". Billboard Canada.
Canadarock344Canada Rock/AlternativeRPMchartid{{Single chart|Canadarock|0|chartid=}}"Top RPM Rock/Alternative Tracks: Image 12345". RPM. Library and Archives Canada.After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Canadatopsingles3412Canada Top SinglesRPMchartid{{Single chart|Canadatopsingles|0|chartid=}}"Top RPM Singles: Image 12345". RPM. Library and Archives Canada.
Central AmericaCentral America9Central America AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Central America|0|date=}}"Top 20 Centroamérica música". Monitor Latino.Combines Guatemala, El Salvador, Honduras, Nicaragua, Costa Rica, and Panama.
Central America Anglo70Central America Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Central America Anglo|0|date=}}"Top 20 Centroamérica Anglo música". Monitor Latino.
ChileChile33Chile AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Chile|0|date=}}"Top 20 Chile música". Monitor Latino.Data from May 2, 2016.
Chile Anglo44Chile Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Chile Anglo|0|date=}}"Top 20 Chile Anglo música". Monitor Latino.
ColombiaBillboardcolombiahot10018Colombia Hot 100Billboardartist{{Single chart|Billboardcolombiahot100|0|artist=}}"{artist} Chart History (Colombia Hot 100)". Billboard.
Colombia5Colombia AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Colombia|0|date=}}"Top 20 Colombia música". Monitor Latino.
Colombia Anglo45Colombia Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Colombia Anglo|0|date=}}"Top 20 Colombia Anglo música". Monitor Latino.
Costa RicaCosta Rica18Costa Rica AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Costa Rica|0|date=}}"Top 20 Costa Rica música". Monitor Latino.
Costa Rica Anglo70Costa Rica Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Costa Rica Anglo|0|date=}}"Top 20 Costa Rica Anglo música". Monitor Latino.
Czech RepublicCzech Republic2142Czech Republic AirplayČNS IFPIweek, year{{Single chart|Czech Republic|0|week=|year=}}"ČNS IFPI – CZ Radio – Top 100 – 3. týden 2024" (in Czech). Hitparáda – Radio Top 100 Oficiální. IFPI Czech Republic.Data from 2006w01. Week number is shown in the dropdown list (e.g. '44. týden 2019' means week 44, year 2019). If the link opens the wrong week, add the correct weekId to chartdata-czech.json.
Czechdigital1835Czech Republic Singles DigitalČNS IFPIweek, year{{Single chart|Czechdigital|0|week=|year=}}"ČNS IFPI – CZ Singles Digital – Top 100 – 3. týden 2024" (in Czech). Hitparáda – Digital Top 100 Oficiální. IFPI Czech Republic.Data from 2014w18. Week number is shown in the dropdown list (e.g. '44. týden 2019' means week 44, year 2019). If the link opens the wrong week, add the correct weekId to chartdata-czech.json.
DenmarkDenmark → year, week2313DenmarkTracklistenyear, week{{Single chart|Denmark|0|year=|week=}}"Track Top-40 – Hitlisten.NU – Danmarks officielle hitlister" (in Danish). Tracklisten.Data from 2007.
Denmark → artist, songartist, song{{Single chart|Denmark|0|artist=|song=}}"{artist} – {song}". Tracklisten.Data from 2001. May vary from official positions for older songs.
Denmark Airplay142Denmark AirplayTracklistenweek, year{{Single chart|Denmark Airplay|0|week=|year=}}"Airplay Top-20 – Hitlisten.NU – Danmarks officielle hitlister" (in Danish). Tracklisten.
Dominican RepublicDominican Republic5Dominican Republic AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Dominican Republic|0|date=}}"Top 20 República Dominicana música". Monitor Latino.
Dominican Republic Anglo70Dominican Republic Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Dominican Republic Anglo|0|date=}}"Top 20 República Dominicana Anglo música". Monitor Latino.
EcuadorEcuador10Ecuador AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Ecuador|0|date=}}"Top 20 Ecuador música". Monitor Latino.
Ecuador Anglo72Ecuador Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Ecuador Anglo|0|date=}}"Top 20 Ecuador Anglo música". Monitor Latino.
El SalvadorEl Salvador12El Salvador AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|El Salvador|0|date=}}"Top 20 El Salvador música". Monitor Latino.Data from August 21, 2017.
El Salvador Anglo43El Salvador Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|El Salvador Anglo|0|date=}}"Top 20 El Salvador Anglo música". Monitor Latino.
EstoniaEstonia227Estonia AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Estonia|0|date=}}"Top Radio Hits Estonia Weekly Chart". TopHit.
EuropeBillboardeurodigital343Euro Digital Song SalesBillboardartist{{Single chart|Billboardeurodigital|0|artist=}}"{artist} Chart History (Euro Digital Song Sales)". Billboard.
Billboardeuropeanhot100 (defunct)180European Hot 100 SinglesBillboardartist{{Single chart|Billboardeuropeanhot100|0|artist=}}"{artist} Chart History (European Hot 100 Singles)". Billboard. {{dead link|date=November 2021}}
FinlandFinland2359FinlandSuomen virallinen listaartist, song{{Single chart|Finland|0|artist=|song=}}"{artist}: {song}" (in Finnish). Musiikkituottajat.
Finland24FinlandSuomen virallinen listaartist, song{{Single chart|Finland2|0|artist=|song=}}"{artist} – {song}" (in French). Musiikkituottajat.
Finnishairplay285Finland AirplayRadiosoittolistaartist, song{{Single chart|Finnishairplay|0|artist=|song=}}"{artist}: {song}" (in Finnish). Musiikkituottajat.Use for Finnish artists who haven't charted abroad. Omit if the main 'Finland' chart is already used.
Finnishdownload169Finland DownloadLatauslistaartist, song{{Single chart|Finnishdownload|0|artist=|song=}}"{artist}: {song}" (in Finnish). Musiikkituottajat.Use for Finnish artists who haven't charted abroad. Omit if 'Finnishairplay' or 'Findland' chart is already used.
FranceFrance5976FranceSNEPartist, song{{Single chart|France|0|artist=|song=}}"{artist} – {song}" (in French). Le classement de singles.
Frenchdigital28France DownloadSNEPdate [YYYYMMDD]{{Single chart|Frenchdigital|0|date=}}"lescharts.com – Français" (in French). Le classement des téléchargements de singles.
GermanyGermany8123GermanyGfKyear, songid{{Single chart|Germany|0|year=|songid=}}"Offizielle Deutsche Charts" (in German). [year<1977 → To see the peak chart position, click 'TITEL VON', followed by the artist's name]. GfK Entertainment charts.For singles after German reunification (October 3, 1990). Add year for peaks before 1978 (unless Höchstposition shown). songid = numeric part of URL.
West Germany1725West GermanyGfKyear, songid{{Single chart|West Germany|0|year=|songid=}}"Offizielle Deutsche Charts (West Germany)" {{in lang|de}}. [year<1977 → To see the peak chart position, click 'TITEL VON', followed by the artist's name]. GfK Entertainment charts.For singles before German reunification (October 3, 1990). Add year for peaks before 1978 (unless Höchstposition shown). songid = numeric part of URL.
GlobalBillboardglobal2002508Global 200Billboardartist{{Single chart|Billboardglobal200|0|artist=}}"{artist} Chart History (Global 200)". Billboard.
GuatemalaGuatemala33Guatemala AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Guatemala|0|date=}}"Top 20 Guatemala música". Monitor Latino.Data from December 14, 2015.
Guatemala Anglo71Guatemala Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Guatemala Anglo|0|date=}}"Top 20 Guatemala Anglo música". Monitor Latino.
HondurasHonduras9Honduras AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Honduras|0|date=}}"Top 20 Honduras música". Monitor Latino.Data from November 20, 2017.
Honduras Anglo52Honduras Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Honduras Anglo|0|date=}}"Top 20 Honduras Anglo música". Monitor Latino.
HungaryHungary1316 → Hungaryradio
Hungarydance803HungaryDance Top 40year, week{{Single chart|Hungarydance|0|year=|week=}}"Archívum – Slágerlisták – MAHASZ" (in Hungarian). Dance Top 40 lista. Magyar Hanglemezkiadók Szövetsége.
Hungaryradio399HungaryRádiós Top 40year, week{{Single chart|Hungaryradio|0|year=|week=}}"Archívum – Slágerlisták – MAHASZ" (in Hungarian). Rádiós Top 40 játszási lista. Magyar Hanglemezkiadók Szövetsége.The main chart for Hungary.
Hungarysingle2144HungarySingle Top 40year, week{{Single chart|Hungarysingle|0|year=|week=}}"Archívum – Slágerlisták – MAHASZ" (in Hungarian). Single (track) Top 40 lista. Magyar Hanglemezkiadók Szövetsége.
Hungarystream760HungaryStream Top 40year, week{{Single chart|Hungarystream|0|year=|week=}}"Archívum – Slágerlisták – MAHASZ" (in Hungarian). Stream Top 40 slágerlista. Magyar Hanglemezkiadók Szövetsége.
IrelandIreland1156IrelandIRMAyear, week{{Single chart|Ireland|0|year=|week=}}"Chart Track: Week 3, 2024". Irish Singles Chart. Archived from the original.Week 1–53, no leading zero. Data 2000–2016.
Ireland2 → artist5929IrelandIRMAartist{{Single chart|Ireland2|0|artist=}}"The Irish Charts – Search Results – {artist}". Irish Singles Chart.Links to search results page.
Ireland2 → songsong{{Single chart|Ireland2|0|song=}}"The Irish Charts – Search Results – {song}". Irish Singles Chart.
Ireland31655IrelandIRMAartist{{Single chart|Ireland3|0|artist=}}"Irish-charts.com – Discography {artist}". Irish Singles Chart.Links to the artist's discography.
IsraelIsrael International174Israel International AirplayMedia Forestweek, year{{Single chart|Israel International|0|week=|year=}}"The Weekly Israeli Chart – Week 3, 2024". Media Forest. Note: Click on "שירים מובילים - רדיו - בינלאומי" (Top Songs – Radio – International) to see the international chart.Data from 2015.
Israelairplay (defunct)246Israel International AirplayMedia Forestyear, week{{Single chart|Israelairplay|0|year=|week=}}"Media Forest Week 3, 2024". Israeli Airplay Chart. Media Forest. {{dead link|date=November 2016}}Data from 2009 to 2016.
ItalyItaly2556ItalyFIMIartist, song{{Single chart|Italy|0|artist=|song=}}"{artist} – {song}". Top Digital Download.
ItalyFIMI115ItalyFIMIyear, week{{Single chart|ItalyFIMI|0|year=|week=}}"Singoli 3 2024 – Archivio classifiche settimanali". Federazione Industria Musicale Italiana.
JapanBillboardjapanhot100910Japan Hot 100Billboardartist{{Single chart|Billboardjapanhot100|0|artist=}}"{artist} Chart History (Japan Hot 100)". Billboard.
Oricon → date<2021-03-1585JapanOricondate [YYYY-MM-DD]{{Single chart|Oricon|0|date=}}"Oricon Weekly Single Ranking – 2024-01-15". Oricon News. Archived from the original.Weekly rankings only; use 'Oricon2' for peak. Charts before March 15, 2021 are available only in the archive.
Oricon → date>=2021-03-15date [YYYY-MM-DD]{{Single chart|Oricon|0|date=}}"Oricon Weekly Single Ranking – 2024-01-15". Oricon News.
Oricon277JapanOriconartistid, songid{{Single chart|Oricon2|0|artistid=|songid=}}"Song on Oricon News". Oricon News.Direct song page with peak. URL format: /prof/{artistid}/products/{songid}/1/.
KazakhstanKazakhstan139Kazakhstan AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Kazakhstan|0|date=}}"Top Radio Hits Kazakhstan Weekly Chart". TopHit.
LatviaLatvia29Latvia AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Latvia|0|date=}}"Top Radio Hits Latvia Weekly Chart". TopHit.
LithuaniaLithuania91Lithuania AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Lithuania|0|date=}}"Top Radio Hits Lithuania Weekly Chart". TopHit.
LuxembourgLuxembourgdigitalsongs (defunct)76Luxembourg Digital Song SalesBillboardartist{{Single chart|Luxembourgdigitalsongs|0|artist=}}"{artist} Chart History (Luxembourg Digital Song Sales)". Billboard. {{dead link|date=November 2021}}
MexicoMexico Anglo66Mexico Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Mexico Anglo|0|date=}}"Top 20 México Anglo música". Monitor Latino.
Mexico ML19Mexico AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Mexico ML|0|date=}}"Top 20 México música". Monitor Latino.
MoldovaMoldova107Moldova AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Moldova|0|date=}}"Top Radio Hits Moldova Weekly Chart". TopHit.
NetherlandsDutch1009958NetherlandsSingle Top 100artist, song{{Single chart|Dutch100|0|artist=|song=}}"{artist} – {song}" (in Dutch). Single Top 100.
Dutch40 → year, week6292NetherlandsDutch Top 40year, week{{Single chart|Dutch40|0|year=|week=}}"Nederlandse Top 40 – week 3, 2024" (in Dutch). Dutch Top 40.Week 1–53, no leading zero.
Dutch40 → artistartist{{Single chart|Dutch40|0|artist=}}"Nederlandse Top 40 – {artist}" (in Dutch). Dutch Top 40.Links to search results page.
New ZealandNew Zealand7140New ZealandRecorded Music NZartist, song{{Single chart|New Zealand|0|artist=|song=}}"{artist} – {song}". Top 40 Singles.
NicaraguaNicaragua12Nicaragua AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Nicaragua|0|date=}}"Top 20 Nicaragua música". Monitor Latino.Data from November 27, 2017.
Nicaragua Anglo75Nicaragua Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Nicaragua Anglo|0|date=}}"Top 20 Nicaragua Anglo música". Monitor Latino.
NorwayNorway → year, week3652NorwayVG-listayear, week{{Single chart|Norway|0|year=|week=}}"Topp 20 Single uke 3, 2024 – VG-lista. Offisielle hitlister fra og med 1958" (in Norwegian). VG-lista.
Norway → artist, songartist, song{{Single chart|Norway|0|artist=|song=}}"{artist} – {song}". VG-lista.
PanamaPanama22Panama AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Panama|0|date=}}"Top 20 Panamá música". Monitor Latino.Data from December 5, 2016.
Panama Anglo55Panama Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Panama Anglo|0|date=}}"Top 20 Panamá Anglo música". Monitor Latino.
ParaguayParaguay37Paraguay AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Paraguay|0|date=}}"Top 20 Paraguay música". Monitor Latino.Data from February 27, 2017.
Paraguay Anglo50Paraguay Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Paraguay Anglo|0|date=}}"Top 20 Paraguay Anglo música". Monitor Latino.
PeruPeru21Peru AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Peru|0|date=}}"Top 20 Perú música". Monitor Latino.
Peru Anglo58Peru Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Peru Anglo|0|date=}}"Top 20 Perú Anglo música". Monitor Latino.
PhilippinesPhilippines99Philippines Hot 100Billboard Philippinesdate [MM-DD-YYYY]{{Single chart|Philippines|0|date=}}"Philippines Hot 100 – Week of January 15, 2024". Billboard Philippines.Data from July 6, 2024.
Philippines Top Songs7Philippines Top SongsBillboard Philippinesdate [MM-DD-YYYY]{{Single chart|Philippines Top Songs|0|date=}}"Top Philippine Songs – Week of January 15, 2024". Billboard Philippines.
PolandPoland (defunct)1116Poland AirplayZPAVyear, chartid{{Single chart|Poland|0|year=|chartid=}}"Bestsellery i wyróżnienia - AirPlays - Top - Archiwum" (in Polish). ZPAV. Archived from the original. {{dead link|date=February 2025}}Data from March 2010 to January 2023. 'chartid' is the end of the url for the chart (idlisty=).
Poland20Poland AirplayOLiSdate [DD.MM.YYYY]{{Single chart|Poland2|0|date=}}"OLiS – oficjalna lista airplay" (in Polish). OLiS. Note: Change the date to 15.01.2024 under "zmień zakres od–do:".
Polishdance325Poland DanceZPAVchartid{{Single chart|Polishdance|0|chartid=}}"Opłaty za muzykę - Muzyka w biznesie - Top - listy przebojów" (in Polish). ZPAV.Data from December 2010 to August 2018.
PortugalPortugal2119PortugalAFPartist, song{{Single chart|Portugal|0|artist=|song=}}"{artist} – {song}". AFP Top 100 Singles.
Portugalairplay52Portugal AirplayAFPchartid{{Single chart|Portugalairplay|0|chartid=}}"TOP 100 - Lista". Audiogest.
Portugaldigitalsongs (defunct)66Portugal Digital Song SalesBillboardartist{{Single chart|Portugaldigitalsongs|0|artist=}}"{artist} Chart History (Portugal Digital Song Sales)". Billboard. {{dead link|date=November 2021}}
Puerto RicoPuerto Rico17Puerto Rico AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Puerto Rico|0|date=}}"Top 20 Puerto Rico música". Monitor Latino.Data from August 13, 2018.
Puerto Rico Anglo41Puerto Rico Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Puerto Rico Anglo|0|date=}}"Top 20 Puerto Rico Anglo música". Monitor Latino.
RomaniaRomaniaradioairplay234Romania AirplayMedia Forestyear, week{{Single chart|Romaniaradioairplay|0|year=|week=}}"Media Forest – Weekly Charts". Media Forest. Note: Romanian and international positions are rendered together by the number of plays before resulting an overall chart.Week 01–53, leading zero required. Combine Romanian and International columns by broadcasts for peak.
Romaniatvairplay152Romania TV AirplayMedia Forestyear, week{{Single chart|Romaniatvairplay|0|year=|week=}}"Media Forest – Weekly Charts". Media Forest. Note: Select 'Songs – TV'. Romanian and international positions are rendered together by the number of plays before resulting an overall chart.
RussiaRussiaradio634Russia AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Russiaradio|0|date=}}"Top Radio Hits Russia Weekly Chart". TopHit.
SlovakiaSlovakdigital (defunct) → year+week<=2016+34381Slovakia Singles DigitalČNS IFPIyear, week{{Single chart|Slovakdigital|0|year=|week=}}"ČNS IFPI" (in Czech). Hitparáda – Singles Digital Top 100 Oficiálna. IFPI Czech Republic. Note: Select SINGLES DIGITAL - TOP 100 and insert 20243 into search.Data from 2014w26 to 2016w34. Week format: leading zero required.
Slovakdigital (defunct) → year+week>2016+34year, week{{Single chart|Slovakdigital|0|year=|week=}}"ČNS IFPI" (in Czech). Hitparáda – Singles Digital Top 100 Oficiálna. IFPI Czech Republic. Note: Select SINGLES DIGITAL - TOP 100 and insert 20243 into search.Data from 2016w35. Week format: leading zero required.
Slovakdigital21370Slovakia Singles DigitalČNS IFPIweek, year{{Single chart|Slovakdigital2|0|week=|year=}}"ČNS IFPI – SK Singles Digital – Top 100 – 3. týden 2024" (in Czech). Hitparáda – Singles Digital Top 100 Oficiálna. IFPI Czech Republic.Data from 2016w43. Week number is shown in the dropdown list (e.g. '44. týden 2019' means week 44). If the link opens the wrong week, add the correct weekId to chartdata-czech.json.
Slovakia (defunct) → year+week<=2016+341185Slovakia AirplayČNS IFPIyear, week{{Single chart|Slovakia|0|year=|week=}}"ČNS IFPI" (in Czech). Hitparáda – Radio Top 100 Oficiálna. IFPI Czech Republic. Note: insert 20243 into search.Data from 2006w35 to 2016w34. Week format: leading zero required.
Slovakia (defunct) → year+week>2016+34year, week{{Single chart|Slovakia|0|year=|week=}}"ČNS IFPI" (in Czech). Hitparáda – Radio Top 100 Oficiálna. IFPI Czech Republic. Note: insert 20243 into search.Data from 2016w35. Week format: leading zero required.
Slovakia2935Slovakia AirplayČNS IFPIweek, year{{Single chart|Slovakia2|0|week=|year=}}"ČNS IFPI – SK Radio – Top 100 – 3. týden 2024" (in Czech). Hitparáda – Radio Top 100 Oficiálna. IFPI Czech Republic.Data from 2016w43. Week number is shown in the dropdown list (e.g. '44. týden 2019' means week 44). If the link opens the wrong week, add the correct weekId to chartdata-czech.json.
South AfricaSouth Africa (defunct)150South AfricaEMAdate [YYYY-MM-DD]{{Single chart|South Africa|0|date=}}"EMA Top 10 Airplay: Week Ending 2024-01-15". Entertainment Monitoring Africa.
South Africa2 → year=2021261South Africa StreamingTOSACyear, week{{Single chart|South Africa2|0|year=|week=}}"Local & International Streaming Chart Top 100 Week 3". The Official South African Charts.Data starting from October 2021 (week 43). Some weeks are missing. All years use leading zeros for week numbers, except 2024, where they must be omitted.
South Africa2week, year{{Single chart|South Africa2|0|week=|year=}}"Local & International Streaming Chart Top 10 Week 3-2024". The Official South African Charts.
SpainSpain2283SpainPromusicaeartist, song{{Single chart|Spain|0|artist=|song=}}"{artist} – {song}". Canciones Top 50.
SwedenSweden6345SwedenSverigetopplistanartist, song{{Single chart|Sweden|0|artist=|song=}}"{artist} – {song}". Singles Top 100.
 SwitzerlandSwiss Romandy50SwitzerlandMedia Control Romandyartist, song{{Single chart|Swiss Romandy|0|artist=|song=}}"{artist} – {song}" (in French). Media Control.
Switzerland8339SwitzerlandSchweizer Hitparadeartist, song{{Single chart|Switzerland|0|artist=|song=}}"{artist} – {song}". Swiss Singles Chart.
UkraineUkraineradio519Ukraine AirplayTopHitdate [YYYYMMDD-YYYYMMDD]{{Single chart|Ukraineradio|0|date=}}"Top Radio Hits Ukraine Weekly Chart". TopHit.
United KingdomIreland41209IrelandIRMAdate [YYYYMMDD]{{Single chart|Ireland4|0|date=}}"Official Irish Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
Scotland7900Scotland SinglesOCCdate [YYYYMMDD]{{Single chart|Scotland|0|date=}}"Official Scottish Singles Sales Chart on 15/1/2024 – Top 100". Official Charts Company.
UK12649UK SinglesOCCdate [YYYYMMDD]{{Single chart|UK|0|date=}}"Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.
UKZobbel64UK SinglesOCCdate [YYMMDD]{{Single chart|UKZobbel|0|date=}}"Chart Log UK: 15.01.2011". UK singles chart. Zobbel.de.
UKafrobeats87UK AfrobeatsOCCdate [YYYYMMDD]{{Single chart|UKafrobeats|0|date=}}"Official Afrobeats Chart on 15/1/2024 – Top 20". Official Charts Company.
UKdance1702UK DanceOCCdate [YYYYMMDD]{{Single chart|UKdance|0|date=}}"Official Dance Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
UKdownload762UK Singles DownloadsOCCdate [YYYYMMDD]{{Single chart|UKdownload|0|date=}}"Official Singles Downloads Chart on 15/1/2024 – Top 100". Official Charts Company.
UKindependent115 → UKindie
UKindie1269UK IndieOCCdate [YYYYMMDD]{{Single chart|UKindie|0|date=}}"Official Independent Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
UKphysical13UK Physical SinglesOCCdate [YYYYMMDD]{{Single chart|UKphysical|0|date=}}"Official Physical Singles Chart on 15/1/2024". Official Charts Company.
UKrandb2585UK Hip Hop/R&BOCCdate [YYYYMMDD]{{Single chart|UKrandb|0|date=}}"Official Hip Hop and R&B Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
UKrock707UK Rock & MetalOCCdate [YYYYMMDD]{{Single chart|UKrock|0|date=}}"Official Rock & Metal Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
UKsinglesbyname → artistid3954UK SinglesOCCartistid, artist{{Single chart|UKsinglesbyname|0|artistid=|artist=}}"{artist} Songs and Albums | Full Official Chart History". Official Charts Company.
UKsinglesbyname → artistartist{{Single chart|UKsinglesbyname|0|artist=}}"Search results for "{artist}" | Official Chart". Official Charts Company.Links to search results page. Use artistid for direct link.
UKstreaming181UK Audio StreamingOCCdate [YYYYMMDD]{{Single chart|UKstreaming|0|date=}}"Official Audio Streaming Chart on 15/1/2024 – Top 100". Official Charts Company.
United StatesBillboardadultalternativesongs746US Adult Alternative AirplayBillboardartist{{Single chart|Billboardadultalternativesongs|0|artist=}}"{artist} Chart History (Adult Alternative Airplay)". Billboard.
Billboardadultcontemporary3080US Adult ContemporaryBillboardartist{{Single chart|Billboardadultcontemporary|0|artist=}}"{artist} Chart History (Adult Contemporary)". Billboard.
Billboardadultpopsongs2708US Adult Pop AirplayBillboardartist{{Single chart|Billboardadultpopsongs|0|artist=}}"{artist} Chart History (Adult Pop Songs)". Billboard.
Billboardadultrandbsongs293US Adult R&B SongsBillboardartist{{Single chart|Billboardadultrandbsongs|0|artist=}}"{artist} Chart History (Adult R&B Songs)". Billboard.
Billboardafrobeats48US Afrobeats SongsBillboardartist{{Single chart|Billboardafrobeats|0|artist=}}"{artist} Chart History (Afrobeats Songs)". Billboard.
Billboardalternativesongs1903US Alternative AirplayBillboardartist{{Single chart|Billboardalternativesongs|0|artist=}}"{artist} Chart History (Alternative Airplay)". Billboard.
Billboardbubbling1002331US Bubbling Under Hot 100Billboardartist{{Single chart|Billboardbubbling100|0|artist=}}"{artist} Chart History (Bubbling Under Hot 100)". Billboard.
Billboardchristianairplay239US Christian AirplayBillboardartist{{Single chart|Billboardchristianairplay|0|artist=}}"{artist} Chart History (Christian Airplay)". Billboard.
Billboardchristiansongs416US Hot Christian SongsBillboardartist{{Single chart|Billboardchristiansongs|0|artist=}}"{artist} Chart History (Hot Christian Songs)". Billboard.
Billboardcountryairplay1157US Country AirplayBillboardartist{{Single chart|Billboardcountryairplay|0|artist=}}"{artist} Chart History (Country Airplay)". Billboard.
Billboardcountrysongs6203US Hot Country SongsBillboardartist{{Single chart|Billboardcountrysongs|0|artist=}}"{artist} Chart History (Hot Country Songs)". Billboard.
Billboarddanceairplay944US Dance/Mix Show AirplayBillboardartist{{Single chart|Billboarddanceairplay|0|artist=}}"{artist} Chart History (Dance Mix/Show Airplay)". Billboard.
Billboarddanceclubplay2565US Dance Club SongsBillboardartist{{Single chart|Billboarddanceclubplay|0|artist=}}"{artist} Chart History (Dance Club Songs)". Billboard.
Billboarddanceelectronic1099US Hot Dance/Electronic SongsBillboardartist{{Single chart|Billboarddanceelectronic|0|artist=}}"{artist} Chart History (Hot Dance/Electronic Songs)". Billboard.
Billboarddancepop59US Hot Dance/Pop SongsBillboardartist{{Single chart|Billboarddancepop|0|artist=}}"{artist} Chart History (Hot Dance/Pop Songs)". Billboard.
Billboarddancesales905US Dance Singles SalesBillboardartist{{Single chart|Billboarddancesales|0|artist=}}"{artist} Chart History (Dance Singles Sales)". Billboard.
Billboarddigitalsongs422US Digital Song SalesBillboardartist{{Single chart|Billboarddigitalsongs|0|artist=}}"{artist} Chart History (Digital Song Sales)". Billboard.
Billboardhardrock16US Hot Hard Rock SongsBillboardartist{{Single chart|Billboardhardrock|0|artist=}}"{artist} Chart History (Hot Hard Rock Songs)". Billboard.
Billboardhot10013185US Billboard Hot 100—artist{{Single chart|Billboardhot100|0|artist=}}"{artist} Chart History (Hot 100)". Billboard.
Billboardhotalternativesongs5US Hot Alternative SongsBillboardartist{{Single chart|Billboardhotalternativesongs|0|artist=}}"{artist} Chart History (Hot Alternative Songs)". Billboard.
Billboardlatinairplay537US Latin AirplayBillboardartist{{Single chart|Billboardlatinairplay|0|artist=}}"{artist} Chart History (Latin Airplay)". Billboard.
Billboardlatinpopsongs640US Latin Pop AirplayBillboardartist{{Single chart|Billboardlatinpopsongs|0|artist=}}"{artist} Chart History (Latin Pop Airplay)". Billboard.
Billboardlatinpopsongs28US Hot Latin Pop SongsBillboardartist{{Single chart|Billboardlatinpopsongs2|0|artist=}}"{artist} Chart History (Hot Latin Pop Songs)". Billboard.
Billboardlatinrhythm291US Latin Rhythm AirplayBillboardartist{{Single chart|Billboardlatinrhythm|0|artist=}}"{artist} Chart History (Latin Rhythm Airplay)". Billboard.
Billboardlatinrhythmsongs216US Hot Latin Rhythm SongsBillboardartist{{Single chart|Billboardlatinrhythmsongs2|0|artist=}}"{artist} Chart History (Hot Latin Rhythm Songs)". Billboard.
Billboardlatinsongs1294US Hot Latin SongsBillboardartist{{Single chart|Billboardlatinsongs|0|artist=}}"{artist} Chart History (Hot Latin Songs)". Billboard.
Billboardmainstreamrock1992US Mainstream RockBillboardartist{{Single chart|Billboardmainstreamrock|0|artist=}}"{artist} Chart History (Mainstream Rock)". Billboard.
Billboardpopsongs3780US Pop AirplayBillboardartist{{Single chart|Billboardpopsongs|0|artist=}}"{artist} Chart History (Pop Songs)". Billboard.
Billboardradiosongs281US Radio SongsBillboardartist{{Single chart|Billboardradiosongs|0|artist=}}"{artist} Chart History (Radio Songs)". Billboard.
Billboardrandbhiphop5933US Hot R&B/Hip-Hop SongsBillboardartist{{Single chart|Billboardrandbhiphop|0|artist=}}"{artist} Chart History (Hot R&B/Hip-Hop Songs)". Billboard.
Billboardrandbhiphopairplay503US R&B/Hip-Hop AirplayBillboardartist{{Single chart|Billboardrandbhiphopairplay|0|artist=}}"{artist} Chart History (R&B/Hip-Hop Airplay)". Billboard.
Billboardrandbsongs8US Hot R&B SongsBillboardartist{{Single chart|Billboardrandbsongs|0|artist=}}"{artist} Chart History (Hot R&B Songs)". Billboard.
Billboardrapsongs1277US Hot Rap SongsBillboardartist{{Single chart|Billboardrapsongs|0|artist=}}"{artist} Chart History (Hot Rap Songs)". Billboard.
Billboardregionalmexican91US Regional Mexican AirplayBillboardartist{{Single chart|Billboardregionalmexican|0|artist=}}"{artist} Chart History (Regional Mexican Airplay)". Billboard.
Billboardregionalmexicansongs5US Hot Regional Mexican SongsBillboardartist{{Single chart|Billboardregionalmexicansongs|0|artist=}}"{artist} Chart History (Hot Regional Mexican Songs)". Billboard.
Billboardrhythmic3348US Rhythmic AirplayBillboardartist{{Single chart|Billboardrhythmic|0|artist=}}"{artist} Chart History (Rhythmic Airplay)". Billboard.
Billboardrockairplay929US Rock & Alternative AirplayBillboardartist{{Single chart|Billboardrockairplay|0|artist=}}"{artist} Chart History (Rock & Alternative Airplay)". Billboard.
Billboardrocksongs1866US Hot Rock & Alternative SongsBillboardartist{{Single chart|Billboardrocksongs|0|artist=}}"{artist} Chart History (Hot Rock & Alternative Songs)". Billboard.
Billboardsinglessales (defunct)11US Hot Singles SalesBillboardartist{{Single chart|Billboardsinglessales|0|artist=}}"{artist} Chart History (Hot Singles Sales)". Billboard. {{dead link|date=November 2021}}
Billboardsmoothjazzsongs25US Smooth Jazz AirplayBillboardartist{{Single chart|Billboardsmoothjazzsongs|0|artist=}}"{artist} Chart History (Smooth Jazz Airplay)". Billboard.
Billboardtropicalairplay406US Tropical AirplayBillboardartist{{Single chart|Billboardtropicalairplay|0|artist=}}"{artist} Chart History (Tropical Airplay)". Billboard.
Billboardtropicalsongs28US Hot Tropical SongsBillboardartist{{Single chart|Billboardtropicalsongs2|0|artist=}}"{artist} Chart History (Hot Tropical Songs)". Billboard.
UruguayUruguay24Uruguay AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Uruguay|0|date=}}"Top 20 Uruguay música". Monitor Latino.
Uruguay Anglo52Uruguay Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Uruguay Anglo|0|date=}}"Top 20 Uruguay Anglo música". Monitor Latino.
VenezuelaVenezuela4Venezuela AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Venezuela|0|date=}}"Top 20 Venezuela música". Monitor Latino.
Venezuela Anglo51Venezuela Anglo AirplayMonitor Latinodate [YYYYMMDD]{{Single chart|Venezuela Anglo|0|date=}}"Top 20 Venezuela Anglo música". Monitor Latino.

Error handling

As an aid to template users, certain checks are made to verify that the necessary parameters have been entered. The actual references are not checked for whether they correctly support the position claimed or even if the link is functional, but some parameter entries are checked for appropriateness.

Error messages

When a check determines that a required parameter is missing or invalid, an error message is generated in red. For example, if you use an unknown chart name, the result will look like:

ERROR in "Hungary": Unknown chart "Hungary". 19

Common error messages: unknown chart, missing chart parameter, missing required parameters, invalid date format, invalid year format, invalid week format, manual mode missing url/title, URL validation failed.

Preview warnings

Shown in orange only in preview mode (not visible in saved article): unknown parameters, unused parameters, invalid date/year/week format in reference.

For example, if you provide a week parameter for a chart that doesn't use it, a warning like this appears in preview:

Australia (ARIA)[1] WARNING: Unused parameters for "Australia": week. 5
  1. ↑ "Example – Example". ARIA Top 50 Singles.

This warning appears only when previewing — it will not be visible in the saved article, but indicates that the week parameter is ignored for this chart.

This is an incentive to preview the article page before saving your edits. Check both the chart table and the references section for error messages.

Maintenance categories

Usage tracking

  • Category:Single chart usages (193) – contains subcategories for each chart ID
  • Category:Single chart making named ref (10,070) – template created a named reference
  • Category:Single chart used with defunct chart (3,796) – chart marked as no longer active
  • Category:Single chart called without artist (20,211) – artist parameter not provided
  • Category:Single chart called without song (33,854) – song parameter not provided
  • Category:Single chart using manual ref mode (14) – manual reference mode (M) used

Error tracking

  • Category:Single chart used with unknown chart (0) – unrecognized chart ID
  • Category:Single chart used with missing parameters (0) – required parameters not provided
  • Category:Single chart with invalid position (53) – position is not a valid number (1–200) or dash
  • Category:Pages using single chart with unknown parameters (0) – unrecognized parameters used
  • Category:Single chart with unused parameters (903) – parameters provided but not used by chart
  • Category:Single chart with unsubstituted parameters (0) – raw {{{param}}} or {placeholder} detected, likely an issue in code, JSON, or helper
  • Category:Single chart with manual mode missing url or title (0) – manual mode without required url/title

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Single chart in articles based on its TemplateData.

TemplateData for Single chart

Creates a table row for a music chart with reference

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Chart1

Chart identifier. Must match one of the supported charts (e.g., Australia, Billboardhot100)

Stringrequired
Position2

Peak or year-end position on the chart. Use en-dash (–) if not charted

Stringrequired
Manual mode3

Set to M for manual reference mode (requires url and title)

Stringoptional
Artistartist

Artist name as listed on chart. German charts typically require lastname,firstname format. Used for URL construction and default reference naming

Stringsuggested
Songsong

Song title as listed on chart (single charts only)

Stringoptional
Albumalbum

Album title as listed on chart (album charts only)

Stringoptional
DVDdvd

DVD title for Music DVD charts. Use instead of album parameter

Stringoptional
Artist IDartistid

Numeric artist identifier from chart website URL

Numberoptional
Song IDsongid

Numeric song/album identifier from chart website URL

Numberoptional
Chart IDchartid

Numeric chart/archive identifier from URL

Numberoptional
IDid

Alias for chartid

Numberoptional
Yearyear

Four-digit year. Required for year-end charts; used with week parameter for some weekly charts

Numberoptional
Weekweek

Week number 1–53 (1–2 digits) or combined format like 51+52

Stringoptional
Datedate

Chart date for URL construction. Format varies by chart (YYYYMMDD, YYYY-MM-DD, etc.). Not displayed in reference

Stringoptional
Start datestartdate

Chart week start date. Used only for FlandersMV, WalloniaMV, ItalyMV

Stringdeprecated
End dateenddate

Chart week end date. Used only for FlandersMV, WalloniaMV, ItalyMV

Stringdeprecated
URLurl

User-provided URL for charts without automatic indexing, or for manual mode

URLoptional
Titletitle

Source title (required for manual mode)

Stringoptional
Workwork

Publication name (manual mode only)

Stringoptional
Publisherpublisher

Publisher name (manual mode only)

Stringoptional
Locationlocation

Publication location (manual mode only)

Stringoptional
Pagepage

Page number for book sources. Used only with AustraliaKent

Numberoptional
Publish datepublish-date publishdate

Chart publication date for display in reference. Used for year-end charts

Dateoptional
Access dateaccess-date accessdate

Date when source was verified by editor

Datesuggested
Archive URLarchive-url archiveurl

URL of archived version of the source

URLoptional
Archive datearchive-date archivedate

Date when the source was archived

Dateoptional
URL statusurl-status

Status of the URL: live or dead (manual mode only)

Stringoptional
Ref namerefname

Custom reference name. Default format: sc_Chart_artist or ye_Chart_year

Stringoptional
Ref grouprefgroup

Reference group name

Stringoptional
Row headerrowheader

Set to true to output chart name as row header (recommended for accessibility)

Default
false
Booleansuggested
Notenote

Note displayed after chart name (e.g., remix version, deluxe edition, then called X)

Stringoptional

See also

  • {{Single chart}}, {{Album chart}} — weekly charts
  • {{Year-end single chart}}, {{Year-end album chart}} — year-end charts
  • Module:Music chart — module documentation
The above documentation is transcluded from Template:Single chart/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template.
Retrieved from "https://en.wikipedia.org/w/index.php?title=Template:Single_chart&oldid=1332208335"