Jump to content

Template:Single chart/sandbox

Add links
From Wikipedia, the free encyclopedia

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

[edit]

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

[edit]

The template produces:

  • A table row: left cell with chart name (with wikilinks) and reference, right cell with centered position
  • A named reference for reuse elsewhere

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"/>.

Parameters

[edit]
Parameter Description
1 Required. 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.
2 Required. Peak position. If song hasn't charted, use en-dash (–), not hyphen (-). Usually better to omit the template entirely.
artist Artist 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.
song Song title. Made-up words, slang, tricky punctuation can produce bad URLs — always preview.
artistid Numeric artist identifier from chart website URL. Example: Madonna at officialcharts.com has URL .../artist/28948/madonna/, so artistid=28948.
songid Numeric song identifier from chart website URL. Example: "In My Mind" at tophit.com has URL tophit.com/tracks/88003, so songid=88003.
chartid, id Numeric 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.
year Four-digit year indicating the year being reported by the chart. Used in combination with week for some charts.
week Week number (01–53) indicating the week being reported by the chart. Used in combination with year. Some charts require leading zero for weeks 01–09, others do not — always preview the resulting URL.
date Date 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.
url User-provided URL for charts without automatic indexing. Some charts validate URL for required domain.
publish-date Publication date of the chart (free-format, for display in reference). Not the same as date which is used for URL construction.
access-date Date when source was verified by editor.
archive-url URL of archived version of the source.
archive-date Date when the source was archived.
rowheader Set to true to output chart name as row header per MOS:DTAB. Should be true in most cases.
refname Custom reference name. Default: sc_{Chart}_{artist}. Names with spaces require quotes in <ref name="..."/>.
refgroup Reference group name.
note Note displayed after chart name (e.g., note=remix version, note=deluxe edition). Useful for distinguishing versions or noting renamed charts.

Chart-specific parameters

Parameter Description
page Page number for book sources. Used only with AustraliaKent ({{cite Kent}}).

Examples

[edit]

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|Hungary|5|year=2024|week=14|rowheader=true}}
|-
{{Single chart|Italy|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
Hungary (Rádiós Top 40)[3] 5
Italy (FIMI)[4]
remix version 		3
UK Singles (OCC)[5] 3
  1. ^ "Example Artist – Example Song". ARIA Top 50 Singles.
  2. ^ "Brazil Hot 100". Billboard Brasil. November 2024.
  3. ^ "Archívum – Slágerlisták – MAHASZ" (in Hungarian). Rádiós Top 40 játszási lista. Magyar Hanglemezkiadók Szövetsége.
  4. ^ "Example Artist – Example Song". Top Digital Download.
  5. ^ "Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.

Manual reference mode

[edit]

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= |publish-date= |access-date= |refname= |refgroup= |rowheader= }}

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

When |3=M is set, manual mode takes full priority — chart-specific parameters (date, year, week, etc.) are not used for URL construction. However, artist is still used for default reference naming.

Supported charts

[edit]

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
Group Chart ID Uses Chart Provider Required params Sample ref output Notes
Argentina Argentina 15 → Billboardargentinahot100
Argentina Anglo 55 Argentina Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Argentina Anglo música". Monitor Latino. Data from June 6, 2016.
Argentina ML 33 Argentina Airplay Monitor Latino date [YYYYMMDD] "Top 20 Argentina música". Monitor Latino.
Billboardargentinahot100 492 Argentina Hot 100 Billboard artist "{artist} Chart History (Argentina Hot 100)". Billboard.
Australia Australia 7000 Australia ARIA artist, song "{artist} – {song}". ARIA Top 50 Singles.
AustraliaKent 26 Australia Kent Music Report page {{cite Kent|page=42}}.
Australiadance 155 Australian Dance ARIA url "[{url} The ARIA Report, Issue ]". ARIA Top 50 Dance Singles. National Library of Australia.
Australiapandora 430 Australia ARIA url "[{url} The ARIA Report, Issue ]". ARIA Top 100 Singles. National Library of Australia.
Australiaurban 527 Australian Urban ARIA url "[{url} The ARIA Report, Issue ]". ARIA Top 40 Urban Singles. National Library of Australia.
Austria Austria 6739 Austria Ö3 Austria Top 40 artist, song "{artist} – {song}" (in German). Ö3 Austria Top 40.
Belarus Belarus 98 Belarus Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Belarus Weekly Chart". TopHit.
Belgium Flanders 7057 Belgium Ultratop 50 Flanders artist, song "{artist} – {song}" (in Dutch). Ultratop 50.
Flanders Dance 280 Belgium Dance Ultratop Flanders artist, song "{artist} – {song}" (in Dutch). Ultratop Dance.
Flanders Tip 3263 Belgium Ultratip Bubbling Under Flanders artist, song "{artist} – {song}" (in Dutch). Ultratip.
Flanders Urban 204 Belgium Urban Ultratop Flanders artist, song "{artist} – {song}" (in Dutch). Ultratop Urban.
Wallonia 3956 Belgium Ultratop 50 Wallonia artist, song "{artist} – {song}" (in French). Ultratop 50.
Wallonia Dance 167 Belgium Dance Ultratop Wallonia artist, song "{artist} – {song}" (in French). Ultratop Dance.
Wallonia Tip 2407 Belgium Ultratip Bubbling Under Wallonia artist, song "{artist} – {song}" (in French). Ultratip.
Bolivia Bolivia 36 Bolivia Airplay Monitor Latino date [YYYYMMDD] "Top 20 Bolivia música". Monitor Latino. Data from August 21, 2017.
Bolivia Anglo 60 Bolivia Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Bolivia Anglo música". Monitor Latino.
Brazil Brazil (defunct) 28 Brazil Hot 100 Airplay Billboard Brasil — (no url)
Brazil2 178 Brazil Hot 100 Billboard artist "{artist} Chart History (Brasil Hot 100)". Billboard. Data from September 2, 2023.
Bulgaria Bulgaria 45 Bulgaria Airplay BAMP url "[{url} Airplay Top 5 – ]". Bulgarian Association of Music Producers.
CIS CIS 1476 CIS Airplay TopHit songid "Charts – TopHit – Highway to Airplay". TopHit.
Canada Billboardcanadaac (defunct) 734 Canada AC Billboard artist "{artist} Chart History (Canada AC)". Billboard. {{dead link|date=November 2024}}
Billboardcanadachrtop40 (defunct) 1258 Canada CHR/Top 40 Billboard artist "{artist} Chart History (Canada CHR/Top 40)". Billboard. {{dead link|date=November 2024}}
Billboardcanadacountry 1310 Canada Country Billboard artist "{artist} Chart History (Canada Country)". Billboard.
Billboardcanadahotac (defunct) 1108 Canada Hot AC Billboard artist "{artist} Chart History (Canada Hot AC)". Billboard. {{dead link|date=November 2024}}
Billboardcanadarock (defunct) 730 Canada Rock Billboard artist "{artist} Chart History (Canada Rock)". Billboard. {{dead link|date=November 2024}}
Billboardcanadianhot100 733 Canada Hot 100 Billboard artist "{artist} Chart History (Canadian Hot 100)". Billboard.
Canada 5607 → Billboardcanadianhot100
Canadaadultcontemporary 1365 Canada Adult Contemporary RPM 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.
Canadacountry 1808 Canada Country Tracks RPM chartid "Top RPM Country Tracks: Image 12345". RPM. Library and Archives Canada.
Canadadance 573 Canada Dance/Urban RPM chartid "Top RPM Dance/Urban: Image 12345". RPM. Library and Archives Canada.
Canadamainstreamrock 44 Canada Mainstream Rock Billboard Canada date [YYYY-MM-DD] "Canada Mainstream Rock for the week of January 15, 2024". Billboard Canada. Data from February 1, 2025.
Canadamodernrock 44 Canada Modern Rock Billboard Canada date [YYYY-MM-DD] "Canada Modern Rock for the week of January 15, 2024". Billboard Canada.
Canadarock 344 Canada Rock/Alternative RPM 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.
Canadatopsingles 3420 Canada Top Singles RPM chartid "Top RPM Singles: Image 12345". RPM. Library and Archives Canada.
Central America Central America 10 Central America Airplay Monitor Latino date [YYYYMMDD] "Top 20 Centroamérica música". Monitor Latino. Data from 28 November, 2022. Combines Guatemala, El Salvador, Honduras, Nicaragua, Costa Rica, and Panama.
Central America Anglo 76 Central America Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Centroamérica Anglo música". Monitor Latino.
Chile Chile 34 Chile Airplay Monitor Latino date [YYYYMMDD] "Top 20 Chile música". Monitor Latino. Data from May 2, 2016.
Chile Anglo 51 Chile Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Chile Anglo música". Monitor Latino.
Colombia Billboardcolombiahot100 21 Colombia Hot 100 Billboard artist "{artist} Chart History (Colombia Hot 100)". Billboard.
Colombia 5 Colombia Airplay Monitor Latino date [YYYYMMDD] "Top 20 Colombia música". Monitor Latino.
Colombia Anglo 50 Colombia Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Colombia Anglo música". Monitor Latino.
Costa Rica Costa Rica 19 Costa Rica Airplay Monitor Latino date [YYYYMMDD] "Top 20 Costa Rica música". Monitor Latino.
Costa Rica Anglo 73 Costa Rica Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Costa Rica Anglo música". Monitor Latino.
Czech Republic Czech Republic 2148 Czech Republic Airplay ČNS IFPI 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.
Czechdigital 1845 Czech Republic Singles Digital ČNS IFPI 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.
Denmark Denmark → year, week 2316 Denmark Tracklisten year, week "Track Top-40 – Hitlisten.NU – Danmarks officielle hitlister" (in Danish). Tracklisten. Data from 2007.
Denmark → artist, song artist, song "{artist} – {song}". Tracklisten. Data from 2001. May vary from official positions for older songs.
Denmark Airplay 141 Denmark Airplay Tracklisten week, year "Airplay Top-20 – Hitlisten.NU – Danmarks officielle hitlister" (in Danish). Tracklisten.
Dominican Republic Dominican Republic 5 Dominican Republic Airplay Monitor Latino date [YYYYMMDD] "Top 20 República Dominicana música". Monitor Latino.
Dominican Republic Anglo 72 Dominican Republic Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 República Dominicana Anglo música". Monitor Latino.
Ecuador Ecuador 11 Ecuador Airplay Monitor Latino date [YYYYMMDD] "Top 20 Ecuador música". Monitor Latino.
Ecuador Anglo 78 Ecuador Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Ecuador Anglo música". Monitor Latino.
El Salvador El Salvador 14 El Salvador Airplay Monitor Latino date [YYYYMMDD] "Top 20 El Salvador música". Monitor Latino. Data from August 21, 2017.
El Salvador Anglo 44 El Salvador Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 El Salvador Anglo música". Monitor Latino.
Estonia Estonia 234 Estonia Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Estonia Weekly Chart". TopHit.
Europe Billboardeurodigital 347 Euro Digital Song Sales Billboard artist "{artist} Chart History (Euro Digital Song Sales)". Billboard.
Billboardeuropeanhot100 (defunct) 180 European Hot 100 Singles Billboard artist "{artist} Chart History (European Hot 100 Singles)". Billboard. {{dead link|date=November 2021}}
Finland Finland 2363 Finland Suomen virallinen lista artist, song "{artist}: {song}" (in Finnish). Musiikkituottajat.
Finland2 3 Finland Suomen virallinen lista artist, song "{artist} – {song}" (in French). Musiikkituottajat.
Finnishairplay 292 Finland Airplay Radiosoittolista 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.
Finnishdownload 170 Finland Download Latauslista 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.
France France 5980 France SNEP artist, song "{artist} – {song}" (in French). Le classement de singles.
Frenchdigital 28 France Download SNEP date [YYYYMMDD] "lescharts.com – Français" (in French). Le classement des téléchargements de singles.
Germany Germany 8141 Germany GfK 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 Germany 1727 West Germany GfK 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.
Global Billboardglobal200 2540 Global 200 Billboard artist "{artist} Chart History (Global 200)". Billboard.
Guatemala Guatemala 34 Guatemala Airplay Monitor Latino date [YYYYMMDD] "Top 20 Guatemala música". Monitor Latino. Data from December 14, 2015.
Guatemala Anglo 74 Guatemala Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Guatemala Anglo música". Monitor Latino.
Honduras Honduras 10 Honduras Airplay Monitor Latino date [YYYYMMDD] "Top 20 Honduras música". Monitor Latino. Data from November 20, 2017.
Honduras Anglo 55 Honduras Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Honduras Anglo música". Monitor Latino.
Hungary Hungary 1321 → Hungaryradio
Hungarydance 813 Hungary Dance Top 40 year, week "Archívum – Slágerlisták – MAHASZ" (in Hungarian). Dance Top 40 lista. Magyar Hanglemezkiadók Szövetsége.
Hungaryradio 398 Hungary Rádiós Top 40 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.
Hungarysingle 2152 Hungary Single Top 40 year, week "Archívum – Slágerlisták – MAHASZ" (in Hungarian). Single (track) Top 40 lista. Magyar Hanglemezkiadók Szövetsége.
Hungarystream 766 Hungary Stream Top 40 year, week "Archívum – Slágerlisták – MAHASZ" (in Hungarian). Stream Top 40 slágerlista. Magyar Hanglemezkiadók Szövetsége.
Ireland Ireland 1157 Ireland IRMA year, week "Chart Track: Week 3, 2024". Irish Singles Chart. Archived from the original. Week 1–53, no leading zero. Data 2000–2016.
Ireland2 → artist 5941 Ireland IRMA artist "The Irish Charts – Search Results – {artist}". Irish Singles Chart. Links to search results page.
Ireland2 → song song "The Irish Charts – Search Results – {song}". Irish Singles Chart.
Ireland3 1657 Ireland IRMA artist "Irish-charts.com – Discography {artist}". Irish Singles Chart. Links to the artist's discography.
Israel Israel International 182 Israel International Airplay Media Forest 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) 246 Israel International Airplay Media Forest year, week "Media Forest Week 3, 2024". Israeli Airplay Chart. Media Forest. {{dead link|date=November 2016}} Data from 2009 to 2016.
Italy Italy 2560 Italy FIMI artist, song "{artist} – {song}". Top Digital Download.
ItalyFIMI 120 Italy FIMI year, week "Singoli 3 2024 – Archivio classifiche settimanali". Federazione Industria Musicale Italiana.
Japan Billboardjapanhot100 915 Japan Hot 100 Billboard artist "{artist} Chart History (Japan Hot 100)". Billboard.
Oricon → date<2021-03-15 85 Japan Oricon date [YYYY-MM-DD] "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-15 date [YYYY-MM-DD] "Oricon Weekly Single Ranking – 2024-01-15". Oricon News.
Oricon2 77 Japan Oricon artistid, songid "Song on Oricon News". Oricon News. Direct song page with peak. URL format: /prof/{artistid}/products/{songid}/1/.
Kazakhstan Kazakhstan 146 Kazakhstan Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Kazakhstan Weekly Chart". TopHit.
Latvia Latvia 32 Latvia Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Latvia Weekly Chart". TopHit.
Lithuania Lithuania 109 Lithuania Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Lithuania Weekly Chart". TopHit.
Luxembourg Luxembourgdigitalsongs (defunct) 76 Luxembourg Digital Song Sales Billboard artist "{artist} Chart History (Luxembourg Digital Song Sales)". Billboard. {{dead link|date=November 2021}}
Mexico Mexico Anglo 68 Mexico Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 México Anglo música". Monitor Latino.
Mexico ML 21 Mexico Airplay Monitor Latino date [YYYYMMDD] "Top 20 México música". Monitor Latino.
Moldova Moldova 115 Moldova Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Moldova Weekly Chart". TopHit.
Netherlands Dutch100 9967 Netherlands Single Top 100 artist, song "{artist} – {song}" (in Dutch). Single Top 100.
Dutch40 → year, week 6300 Netherlands Dutch Top 40 year, week "Nederlandse Top 40 – week 3, 2024" (in Dutch). Dutch Top 40. Week 1–53, no leading zero.
Dutch40 → artist artist "Nederlandse Top 40 – {artist}" (in Dutch). Dutch Top 40. Links to search results page.
New Zealand New Zealand 7154 New Zealand Recorded Music NZ artist, song "{artist} – {song}". Top 40 Singles.
Nicaragua Nicaragua 13 Nicaragua Airplay Monitor Latino date [YYYYMMDD] "Top 20 Nicaragua música". Monitor Latino. Data from November 27, 2017.
Nicaragua Anglo 82 Nicaragua Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Nicaragua Anglo música". Monitor Latino.
Norway Norway → year, week 3659 Norway VG-lista year, week "Topp 20 Single uke 3, 2024 – VG-lista. Offisielle hitlister fra og med 1958" (in Norwegian). VG-lista.
Norway → artist, song artist, song "{artist} – {song}". VG-lista.
Panama Panama 23 Panama Airplay Monitor Latino date [YYYYMMDD] "Top 20 Panamá música". Monitor Latino. Data from December 5, 2016.
Panama Anglo 60 Panama Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Panamá Anglo música". Monitor Latino.
Paraguay Paraguay 43 Paraguay Airplay Monitor Latino date [YYYYMMDD] "Top 20 Paraguay música". Monitor Latino. Data from February 27, 2017.
Paraguay Anglo 48 Paraguay Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Paraguay Anglo música". Monitor Latino.
Peru Peru 23 Peru Airplay Monitor Latino date [YYYYMMDD] "Top 20 Perú música". Monitor Latino.
Peru Anglo 62 Peru Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Perú Anglo música". Monitor Latino.
Philippines Philippines 116 Philippines Hot 100 Billboard Philippines date [MM-DD-YYYY] "Philippines Hot 100 – Week of January 15, 2024". Billboard Philippines. Data from July 6, 2024.
Philippines Top Songs 17 Philippines Top Songs Billboard Philippines date [MM-DD-YYYY] "Top Philippine Songs – Week of January 15, 2024". Billboard Philippines.
Poland Poland (defunct) 1117 Poland Airplay ZPAV 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=).
Poland2 0 Poland Airplay OLiS date [DD.MM.YYYY] "OLiS – oficjalna lista airplay" (in Polish). OLiS. Note: Change the date to 15.01.2024 under "zmień zakres od–do:".
Polishdance 325 Poland Dance ZPAV chartid "Opłaty za muzykę - Muzyka w biznesie - Top - listy przebojów" (in Polish). ZPAV. Data from December 2010 to August 2018.
Portugal Portugal 2118 Portugal AFP artist, song "{artist} – {song}". AFP Top 100 Singles.
Portugalairplay 53 Portugal Airplay AFP chartid "TOP 100 - Lista". Audiogest.
Portugaldigitalsongs (defunct) 66 Portugal Digital Song Sales Billboard artist "{artist} Chart History (Portugal Digital Song Sales)". Billboard. {{dead link|date=November 2021}}
Puerto Rico Puerto Rico 19 Puerto Rico Airplay Monitor Latino date [YYYYMMDD] "Top 20 Puerto Rico música". Monitor Latino. Data from August 13, 2018.
Puerto Rico Anglo 42 Puerto Rico Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Puerto Rico Anglo música". Monitor Latino.
Romania Romaniaradioairplay 237 Romania Airplay Media Forest 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.
Romaniatvairplay 152 Romania TV Airplay Media Forest 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.
Russia Russiaradio 642 Russia Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Russia Weekly Chart". TopHit.
Slovakia Slovakdigital (defunct) → year+week<=2016+34 381 Slovakia Singles Digital ČNS IFPI 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+34 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.
Slovakdigital2 1385 Slovakia Singles Digital ČNS IFPI 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+34 1185 Slovakia Airplay ČNS IFPI 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+34 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.
Slovakia2 943 Slovakia Airplay ČNS IFPI 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 Africa South Africa (defunct) 150 South Africa EMA date [YYYY-MM-DD] "EMA Top 10 Airplay: Week Ending 2024-01-15". Entertainment Monitoring Africa.
South Africa2 → year=2021 261 South Africa Streaming TOSAC 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 Africa2 week, year "Local & International Streaming Chart Top 10 Week 3-2024". The Official South African Charts.
Spain Spain 2287 Spain Promusicae artist, song "{artist} – {song}". Canciones Top 50.
Sweden Sweden 6354 Sweden Sverigetopplistan artist, song "{artist} – {song}". Singles Top 100.
 Switzerland Swiss Romandy 50 Switzerland Media Control Romandy artist, song "{artist} – {song}" (in French). Media Control.
Switzerland 8355 Switzerland Schweizer Hitparade artist, song "{artist} – {song}". Swiss Singles Chart.
Ukraine Ukraineradio 524 Ukraine Airplay TopHit date [YYYYMMDD-YYYYMMDD] "Top Radio Hits Ukraine Weekly Chart". TopHit.
United Kingdom Ireland4 1220 Ireland IRMA date [YYYYMMDD] "Official Irish Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
Scotland 7910 Scotland Singles OCC date [YYYYMMDD] "Official Scottish Singles Sales Chart on 15/1/2024 – Top 100". Official Charts Company.
UK 12678 UK Singles OCC date [YYYYMMDD] "Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.
UKZobbel 65 UK Singles OCC date [YYMMDD] "Chart Log UK: 15.01.2011". UK singles chart. Zobbel.de.
UKafrobeats 88 UK Afrobeats OCC date [YYYYMMDD] "Official Afrobeats Chart on 15/1/2024 – Top 20". Official Charts Company.
UKdance 1709 UK Dance OCC date [YYYYMMDD] "Official Dance Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
UKdownload 765 UK Singles Downloads OCC date [YYYYMMDD] "Official Singles Downloads Chart on 15/1/2024 – Top 100". Official Charts Company.
UKindependent 116 → UKindie
UKindie 1276 UK Indie OCC date [YYYYMMDD] "Official Independent Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
UKphysical 13 UK Physical Singles OCC date [YYYYMMDD] "Official Physical Singles Chart on 15/1/2024". Official Charts Company.
UKrandb 2590 UK Hip Hop/R&B OCC date [YYYYMMDD] "Official Hip Hop and R&B Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
UKrock 708 UK Rock & Metal OCC date [YYYYMMDD] "Official Rock & Metal Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
UKsinglesbyname → artistid 3958 UK Singles OCC artistid, artist "{artist} Songs and Albums | Full Official Chart History". Official Charts Company.
UKsinglesbyname → artist artist "Search results for "{artist}" | Official Chart". Official Charts Company. Links to search results page. Use artistid for direct link.
UKstreaming 181 UK Audio Streaming OCC date [YYYYMMDD] "Official Audio Streaming Chart on 15/1/2024 – Top 100". Official Charts Company.
United States Billboardadultalternativesongs 753 US Adult Alternative Airplay Billboard artist "{artist} Chart History (Adult Alternative Airplay)". Billboard.
Billboardadultcontemporary 3089 US Adult Contemporary Billboard artist "{artist} Chart History (Adult Contemporary)". Billboard.
Billboardadultpopsongs 2717 US Adult Pop Airplay Billboard artist "{artist} Chart History (Adult Pop Songs)". Billboard.
Billboardadultrandbsongs 293 US Adult R&B Songs Billboard artist "{artist} Chart History (Adult R&B Songs)". Billboard.
Billboardafrobeats 48 US Afrobeats Songs Billboard artist "{artist} Chart History (Afrobeats Songs)". Billboard.
Billboardalternativesongs 1902 US Alternative Airplay Billboard artist "{artist} Chart History (Alternative Airplay)". Billboard.
Billboardbubbling100 2340 US Bubbling Under Hot 100 Billboard artist "{artist} Chart History (Bubbling Under Hot 100)". Billboard.
Billboardchristianairplay 241 US Christian Airplay Billboard artist "{artist} Chart History (Christian Airplay)". Billboard.
Billboardchristiansongs 417 US Hot Christian Songs Billboard artist "{artist} Chart History (Hot Christian Songs)". Billboard.
Billboardcountryairplay 1163 US Country Airplay Billboard artist "{artist} Chart History (Country Airplay)". Billboard.
Billboardcountrysongs 6208 US Hot Country Songs Billboard artist "{artist} Chart History (Hot Country Songs)". Billboard.
Billboarddanceairplay 956 US Dance/Mix Show Airplay Billboard artist "{artist} Chart History (Dance Mix/Show Airplay)". Billboard.
Billboarddanceclubplay 2566 US Dance Club Songs Billboard artist "{artist} Chart History (Dance Club Songs)". Billboard.
Billboarddanceelectronic 1104 US Hot Dance/Electronic Songs Billboard artist "{artist} Chart History (Hot Dance/Electronic Songs)". Billboard.
Billboarddancepop 60 US Hot Dance/Pop Songs Billboard artist "{artist} Chart History (Hot Dance/Pop Songs)". Billboard.
Billboarddancesales 912 US Dance Singles Sales Billboard artist "{artist} Chart History (Dance Singles Sales)". Billboard.
Billboarddigitalsongs 427 US Digital Song Sales Billboard artist "{artist} Chart History (Digital Song Sales)". Billboard.
Billboardhardrock 18 US Hot Hard Rock Songs Billboard artist "{artist} Chart History (Hot Hard Rock Songs)". Billboard.
Billboardhot100 13230 US Billboard Hot 100 — artist "{artist} Chart History (Hot 100)". Billboard.
Billboardhotalternativesongs 5 US Hot Alternative Songs Billboard artist "{artist} Chart History (Hot Alternative Songs)". Billboard.
Billboardlatinairplay 537 US Latin Airplay Billboard artist "{artist} Chart History (Latin Airplay)". Billboard.
Billboardlatinpopsongs 638 US Latin Pop Airplay Billboard artist "{artist} Chart History (Latin Pop Airplay)". Billboard.
Billboardlatinpopsongs2 9 US Hot Latin Pop Songs Billboard artist "{artist} Chart History (Hot Latin Pop Songs)". Billboard.
Billboardlatinrhythm 291 US Latin Rhythm Airplay Billboard artist "{artist} Chart History (Latin Rhythm Airplay)". Billboard.
Billboardlatinrhythmsongs2 16 US Hot Latin Rhythm Songs Billboard artist "{artist} Chart History (Hot Latin Rhythm Songs)". Billboard.
Billboardlatinsongs 1294 US Hot Latin Songs Billboard artist "{artist} Chart History (Hot Latin Songs)". Billboard.
Billboardmainstreamrock 1996 US Mainstream Rock Billboard artist "{artist} Chart History (Mainstream Rock)". Billboard.
Billboardpopsongs 3783 US Pop Airplay Billboard artist "{artist} Chart History (Pop Songs)". Billboard.
Billboardradiosongs 281 US Radio Songs Billboard artist "{artist} Chart History (Radio Songs)". Billboard.
Billboardrandbhiphop 5954 US Hot R&B/Hip-Hop Songs Billboard artist "{artist} Chart History (Hot R&B/Hip-Hop Songs)". Billboard.
Billboardrandbhiphopairplay 502 US R&B/Hip-Hop Airplay Billboard artist "{artist} Chart History (R&B/Hip-Hop Airplay)". Billboard.
Billboardrandbsongs 9 US Hot R&B Songs Billboard artist "{artist} Chart History (Hot R&B Songs)". Billboard.
Billboardrapsongs 1277 US Hot Rap Songs Billboard artist "{artist} Chart History (Hot Rap Songs)". Billboard.
Billboardregionalmexican 91 US Regional Mexican Airplay Billboard artist "{artist} Chart History (Regional Mexican Airplay)". Billboard.
Billboardregionalmexicansongs 5 US Hot Regional Mexican Songs Billboard artist "{artist} Chart History (Hot Regional Mexican Songs)". Billboard.
Billboardrhythmic 3357 US Rhythmic Airplay Billboard artist "{artist} Chart History (Rhythmic Airplay)". Billboard.
Billboardrockairplay 933 US Rock & Alternative Airplay Billboard artist "{artist} Chart History (Rock & Alternative Airplay)". Billboard.
Billboardrocksongs 1872 US Hot Rock & Alternative Songs Billboard artist "{artist} Chart History (Hot Rock & Alternative Songs)". Billboard.
Billboardsinglessales (defunct) 11 US Hot Singles Sales Billboard artist "{artist} Chart History (Hot Singles Sales)". Billboard. {{dead link|date=November 2021}}
Billboardsmoothjazzsongs 25 US Smooth Jazz Airplay Billboard artist "{artist} Chart History (Smooth Jazz Airplay)". Billboard.
Billboardtropicalairplay 406 US Tropical Airplay Billboard artist "{artist} Chart History (Tropical Airplay)". Billboard.
Billboardtropicalsongs2 8 US Hot Tropical Songs Billboard artist "{artist} Chart History (Hot Tropical Songs)". Billboard.
Uruguay Uruguay 26 Uruguay Airplay Monitor Latino date [YYYYMMDD] "Top 20 Uruguay música". Monitor Latino.
Uruguay Anglo 54 Uruguay Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Uruguay Anglo música". Monitor Latino.
Venezuela Venezuela 4 Venezuela Airplay Monitor Latino date [YYYYMMDD] "Top 20 Venezuela música". Monitor Latino.
Venezuela Anglo 56 Venezuela Anglo Airplay Monitor Latino date [YYYYMMDD] "Top 20 Venezuela Anglo música". Monitor Latino.

Error handling

[edit]

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

[edit]

When a check determines that a required parameter is missing or invalid, an error message is generated in red. For example, if you forget the week or year value for the Hungary chart, the result will look like:

Hungary (Rádiós Top 40)ERROR in "Hungary": Missing parameters: week, year.[1] 19
  1. ^ ERROR in "Hungary": Missing parameters: week, year. "Archívum – Slágerlisták – MAHASZ" (in Hungarian). Rádiós Top 40 játszási lista. Magyar Hanglemezkiadók Szövetsége.

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

Preview warnings

[edit]

Shown in orange only in preview mode (not visible in saved article): unknown parameters, unused parameters, invalid date 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

[edit]

Usage tracking

[edit]

Error tracking

[edit]

Template data

[edit]
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

Numberrequired
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 01–53. Some charts require leading zero, others do not

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 year-end_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

[edit]


Retrieved from "https://en.wikipedia.org/w/index.php?title=Template:Single_chart/sandbox&oldid=1343672431"