Template:Single chart

Template documentation[view] [edit] [history] [purge]

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

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

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. Must be exactly 4 digits.
week	Week 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.
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

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)	6
Brazil Billboard Hot 100	1
Austria (Ö3 Austria Top 40) remix version	3
UK Singles (OCC)	3

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= |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

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	8	→ Billboardargentinahot100
	Argentina Anglo	31	Argentina Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Argentina Anglo música". Monitor Latino.	Data from June 6, 2016.
	Argentina ML	17	Argentina Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Argentina música". Monitor Latino.
	Billboardargentinahot100	465	Argentina Hot 100	Billboard	artist	"{artist} Chart History (Argentina Hot 100)". Billboard.
Australia	Australia	6959	Australia	ARIA	artist, song	"{artist} – {song}". ARIA Top 50 Singles.
	AustraliaKent	25	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	415	Australia	ARIA	url	"[{url} The ARIA Report, Issue ]". ARIA Top 100 Singles. National Library of Australia.
	Australiaurban	526	Australian Urban	ARIA	url	"[{url} The ARIA Report, Issue ]". ARIA Top 40 Urban Singles. National Library of Australia.
Austria	Austria	6653	Austria	Ö3 Austria Top 40	artist, song	"{artist} – {song}" (in German). Ö3 Austria Top 40.
Belarus	Belarus	80	Belarus Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	"Top Radio Hits Belarus Weekly Chart". TopHit.
Belgium	Flanders	6987	Belgium	Ultratop 50 Flanders	artist, song	"{artist} – {song}" (in Dutch). Ultratop 50.
	Flanders Dance	282	Belgium Dance	Ultratop Flanders	artist, song	"{artist} – {song}" (in Dutch). Ultratop Dance.
	Flanders Tip	3233	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	3905	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	2378	Belgium	Ultratip Bubbling Under Wallonia	artist, song	"{artist} – {song}" (in French). Ultratip.
Bolivia	Bolivia	18	Bolivia Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Bolivia música". Monitor Latino.	Data from August 21, 2017.
	Bolivia Anglo	30	Bolivia Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Bolivia Anglo música". Monitor Latino.
Brazil	Brazil (defunct)	30	Brazil Hot 100 Airplay	Billboard Brasil	—	(no url)
	Brazil2	146	Brazil Hot 100	Billboard	artist	"{artist} Chart History (Brasil Hot 100)". Billboard.	Data from September 2, 2023.
Bulgaria	Bulgaria	42	Bulgaria	IFPI	url	"[{url} Airplay Top 5 – ]". Bulgarian Association of Music Producers.
CIS	CIS	1416	CIS Airplay	TopHit	songid	"Charts – TopHit – Highway to Airplay". TopHit.
Canada	Billboardcanadaac (defunct)	784	Canada AC	Billboard	artist	"{artist} Chart History (Canada AC)". Billboard. {{dead link|date=November 2024}}
	Billboardcanadachrtop40 (defunct)	1320	Canada CHR/Top 40	Billboard	artist	"{artist} Chart History (Canada CHR/Top 40)". Billboard. {{dead link|date=November 2024}}
	Billboardcanadacountry (defunct)	1307	Canada Country	Billboard	artist	"{artist} Chart History (Canada Country)". Billboard. {{dead link|date=November 2024}}
	Billboardcanadahotac (defunct)	1171	Canada Hot AC	Billboard	artist	"{artist} Chart History (Canada Hot AC)". Billboard. {{dead link|date=November 2024}}
	Billboardcanadarock (defunct)	731	Canada Rock	Billboard	artist	"{artist} Chart History (Canada Rock)". Billboard. {{dead link|date=November 2024}}
	Billboardcanadianhot100	731	Canada Hot 100	Billboard	artist	"{artist} Chart History (Canadian Hot 100)". Billboard.
	Canada	5457	→ Billboardcanadianhot100
	Canadaadultcontemporary	1351	Canada Adult Contemporary	RPM	chartid	"Top RPM Adult Contemporary: Issue 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	1810	Canada Country Tracks	RPM	chartid	"Top RPM Country Tracks: Issue 12345". RPM. Library and Archives Canada.
	Canadadance	572	Canada Dance/Urban	RPM	chartid	"Top RPM Dance/Urban: Issue 12345". RPM. Library and Archives Canada.
	Canadamainstreamrock	21	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	23	Canada Modern Rock	Billboard Canada	date [YYYY-MM-DD]	"Canada Modern Rock for the week of January 15, 2024". Billboard Canada.
	Canadarock	333	Canada Rock/Alternative	RPM	chartid	"Top RPM Rock/Alternative Tracks: Issue 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	3359	Canada Top Singles	RPM	chartid	"Top RPM Singles: Issue 12345". RPM. Library and Archives Canada.
Central America	Central America	6	Central America Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Centroamérica música". Monitor Latino.	Combines Guatemala, El Salvador, Honduras, Nicaragua, Costa Rica, and Panama.
	Central America Anglo	42	Central America Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Centroamérica Anglo música". Monitor Latino.
Chile	Chile	22	Chile Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Chile música". Monitor Latino.	Data from May 2, 2016.
	Chile Anglo	24	Chile Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Chile Anglo música". Monitor Latino.
Colombia	Billboardcolombiahot100	4	Colombia Hot 100	Billboard	artist	"{artist} Chart History (Colombia Hot 100)". Billboard.
	Colombia	1	Colombia Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Colombia música". Monitor Latino.
	Colombia Anglo	28	Colombia Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Colombia Anglo música". Monitor Latino.
Costa Rica	Costa Rica	12	Costa Rica Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Costa Rica música". Monitor Latino.
	Costa Rica Anglo	38	Costa Rica Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Costa Rica Anglo música". Monitor Latino.
Czech Republic	Czech Republic	2115	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	1800	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	2288	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	107	Denmark Airplay	Tracklisten	week, year	"Airplay Top-20 – Hitlisten.NU – Danmarks officielle hitlister" (in Danish). Tracklisten.
Dominican Republic	Dominican Republic	1	Dominican Republic Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 República Dominicana música". Monitor Latino.
	Dominican Republic Anglo	44	Dominican Republic Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 República Dominicana Anglo música". Monitor Latino.
Ecuador	Ecuador	7	Ecuador Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Ecuador música". Monitor Latino.
	Ecuador Anglo	41	Ecuador Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Ecuador Anglo música". Monitor Latino.
El Salvador	El Salvador	5	El Salvador Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 El Salvador música". Monitor Latino.
	El Salvador Anglo	18	El Salvador Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 El Salvador Anglo música". Monitor Latino.
Estonia	Estonia	178	Estonia Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	"Top Radio Hits Estonia Weekly Chart". TopHit.
Europe	Billboardeurodigital	339	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	2329	Finland	Suomen virallinen lista	artist, song	"{artist}: {song}" (in Finnish). Musiikkituottajat.
	Finland2	2	Finland	Suomen virallinen lista	artist, song	"{artist} – {song}" (in French). Musiikkituottajat.
	Finnishairplay	168	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	167	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	5914	France	SNEP	artist, song	"{artist} – {song}" (in French). Le classement de singles.
	Frenchdigital	30	France Download	SNEP	date [YYYYMMDD]	"lescharts.com – Français" (in French). Le classement des téléchargements de singles.
Germany	Germany	8032	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	1707	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	2373	Global 200	Billboard	artist	"{artist} Chart History (Global 200)". Billboard.
Guatemala	Guatemala	12	Guatemala Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Guatemala música". Monitor Latino.
	Guatemala Anglo	47	Guatemala Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Guatemala Anglo música". Monitor Latino.
Honduras	Honduras	3	Honduras Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Honduras música". Monitor Latino.
	Honduras Anglo	18	Honduras Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Honduras Anglo música". Monitor Latino.
Hungary	Hungary	1316	→ Hungaryradio
	Hungarydance	801	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	389	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	2129	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	757	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	1159	Ireland	IRMA	year, week	"Chart Track: Week 3, 2024". Irish Singles Chart.	Week 1–53, no leading zero. Data 2000–2016.
	Ireland2 → artist	5892	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	1646	Ireland	IRMA	artist	"Irish-charts.com – Discography {artist}". Irish Singles Chart.	Links to the artist's discography.
Israel	Israel International	105	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)	279	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	2544	Italy	FIMI	artist, song	"{artist} – {song}". Top Digital Download.
	ItalyFIMI	77	Italy	FIMI	year, week	"Singoli 3 2024 – Archivio classifiche settimanali". Federazione Industria Musicale Italiana.
Japan	Billboardjapanhot100	898	Japan Hot 100	Billboard	artist	"{artist} Chart History (Japan Hot 100)". Billboard.
	Oricon	75	Japan	Oricon	date [YYYY-MM-DD]	"Oricon Weekly Single Ranking – 2024-01-15". Oricon News.	Links to weekly rankings, not peak position. Use 'Oricon2' for direct song page with peak.
	Oricon2	71	Japan	Oricon	artistid, songid	"Song on Oricon News". Oricon News.	Direct song page with peak. URL format: /prof/{artistid}/products/{songid}/1/.
Kazakhstan	Kazakhstan	94	Kazakhstan Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	"Top Radio Hits Kazakhstan Weekly Chart". TopHit.
Luxembourg	Luxembourgdigitalsongs (defunct)	75	Luxembourg Digital Song Sales	Billboard	artist	"{artist} Chart History (Luxembourg Digital Song Sales)". Billboard. {{dead link|date=November 2021}}
Mexico	Mexico Anglo	36	Mexico Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 México Anglo música". Monitor Latino.
	Mexico ML	14	Mexico Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 México música". Monitor Latino.
Moldova	Moldova	87	Moldova Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	"Top Radio Hits Moldova Weekly Chart". TopHit.
Netherlands	Dutch100	9869	Netherlands	Single Top 100	artist, song	"{artist} – {song}" (in Dutch). Single Top 100.
	Dutch40 → year, week	6233	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	7091	New Zealand	Recorded Music NZ	artist, song	"{artist} – {song}". Top 40 Singles.
Nicaragua	Nicaragua	6	Nicaragua Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Nicaragua música". Monitor Latino.
	Nicaragua Anglo	36	Nicaragua Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Nicaragua Anglo música". Monitor Latino.
Norway	Norway → year, week	3612	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	14	Panama Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Panamá música". Monitor Latino.	Data from December 5, 2016.
	Panama Anglo	37	Panama Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Panamá Anglo música". Monitor Latino.
Paraguay	Paraguay	25	Paraguay Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Paraguay música". Monitor Latino.	Data from February 27, 2017.
	Paraguay Anglo	24	Paraguay Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Paraguay Anglo música". Monitor Latino.
Peru	Peru	12	Peru Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Perú música". Monitor Latino.
	Peru Anglo	38	Peru Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Perú Anglo música". Monitor Latino.
Philippines	Philippines	52	Philippines Hot 100	Billboard Philippines	date [DD-MM-YYYY]	"Philippines Hot 100 for the week of 15.01.2024". Billboard Philippines.	Data from July 6, 2024.
Poland	Poland	1120	Poland	Polish Airplay Top 100	year, chartid	"Listy bestsellerów, wyróżnienia :: Związek Producentów Audio-Video". Polish Airplay Top 100.	Archived from April 2010 to August 2018. 'chartid' is the end of the url for the chart (idlisty=).
	Poland2	0	Poland	Polish Airplay Top 100	date [DD.MM.YYYY]	"OLiS – oficjalna lista airplay" (in Polish). Polish Airplay Top 100. Note: Change the date to 15.01.2024 under "zmień zakres od–do:".
	Polishdance	325	Poland	Dance Top 50	chartid	"Listy bestsellerów, wyróżnienia :: Związek Producentów Audio-Video". Polish Dance Top 50.
Portugal	Portugal	2067	Portugal	AFP	artist, song	"{artist} – {song}". AFP Top 100 Singles.
	Portugalairplay	44	Portugal Airplay	AFP	chartid	"TOP 100 - Lista". Audiogest.
	Portugaldigitalsongs (defunct)	65	Portugal Digital Song Sales	Billboard	artist	"{artist} Chart History (Portugal Digital Song Sales)". Billboard. {{dead link|date=November 2021}}
Puerto Rico	Puerto Rico	10	Puerto Rico Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Puerto Rico música". Monitor Latino.
	Puerto Rico Anglo	24	Puerto Rico Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Puerto Rico Anglo música". Monitor Latino.
Romania	Romaniaradioairplay	225	Romania	Romanian Radio Airplay	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	141	Romania	Romania TV Airplay	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	592	Russia Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	"Top Radio Hits Russia Weekly Chart". TopHit.
Slovakia	Slovakdigital (defunct) → helper=before2016w34	381	Slovakia Singles Digital	ČNS IFPI	helper, year, week	"ČNS IFPI" (in Slovak). 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) → helper=after2016w34				helper, year, week	"ČNS IFPI" (in Slovak). 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 to 2016w42. Week format: leading zero required.
	Slovakdigital2	1317	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) → helper=before2016w34	1185	Slovakia Airplay	ČNS IFPI	helper, year, week	"ČNS IFPI" (in Slovak). 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) → helper=after2016w34				helper, year, week	"ČNS IFPI" (in Slovak). Hitparáda – Radio Top 100 Oficiálna. IFPI Czech Republic. Note: insert 20243 into search.	Data from 2016w35 to 2016w42. Week format: leading zero required.
	Slovakia2	912	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)	149	South Africa	EMA	date [YYYY-MM-DD]	"EMA Top 10 Airplay: Week Ending 2024-01-15". Entertainment Monitoring Africa.
	South Africa2 → year=2021	259	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	2262	Spain	PROMUSICAE	artist, song	"{artist} – {song}". Canciones Top 50.
Sweden	Sweden	6290	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	8262	Switzerland	Schweizer Hitparade	artist, song	"{artist} – {song}". Swiss Singles Chart.
Ukraine	Ukraine (defunct)	29	Ukraine Airplay	TopHit	date	"Ukraine Airplay Chart for 2024-01-15". TopHit.
	Ukraineradio	482	Ukraine Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	"Top Radio Hits Ukraine Weekly Chart". TopHit.
United Kingdom	Ireland4	1147	Ireland	IRMA	date [YYYYMMDD]	"Official Irish Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
	Scotland	7815	Scotland Singles	OCC	date [YYYYMMDD]	"Official Scottish Singles Sales Chart on 15/1/2024 – Top 100". Official Charts Company.
	UK	12454	UK Singles	OCC	date [YYYYMMDD]	"Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.
	UKZobbel	53	UK Singles	OCC	date [YYMMDD]	"Chart Log UK: 15.01.2011". UK singles chart. Zobbel.de.
	UKafrobeats	80	UK Afrobeats	OCC	date [YYYYMMDD]	"Official Afrobeats Chart on 15/1/2024 – Top 20". Official Charts Company.
	UKdance	1682	UK Dance	OCC	date [YYYYMMDD]	"Official Dance Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
	UKdownload	747	UK Singles Downloads	OCC	date [YYYYMMDD]	"Official Singles Downloads Chart on 15/1/2024 – Top 100". Official Charts Company.
	UKindependent	124	→ UKindie
	UKindie	1219	UK Indie	OCC	date [YYYYMMDD]	"Official Independent Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
	UKrandb	2552	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	677	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	177	UK Audio Streaming	OCC	date [YYYYMMDD]	"Official Audio Streaming Chart on 15/1/2024 – Top 100". Official Charts Company.
United States	Billboardadultalternativesongs	728	US Adult Alternative Airplay	Billboard	artist	"{artist} Chart History (Adult Alternative Airplay)". Billboard.
	Billboardadultcontemporary	3045	US Adult Contemporary	Billboard	artist	"{artist} Chart History (Adult Contemporary)". Billboard.
	Billboardadultpopsongs	2674	US Adult Pop Airplay	Billboard	artist	"{artist} Chart History (Adult Pop Songs)". Billboard.
	Billboardadultrandbsongs	289	US Adult R&B Songs	Billboard	artist	"{artist} Chart History (Adult R&B Songs)". Billboard.
	Billboardafrobeats	42	US Afrobeats Songs	Billboard	artist	"{artist} Chart History (Afrobeats Songs)". Billboard.
	Billboardalternativesongs	1855	US Alternative Airplay	Billboard	artist	"{artist} Chart History (Alternative Airplay)". Billboard.
	Billboardbubbling100	2289	US Bubbling Under Hot 100	Billboard	artist	"{artist} Chart History (Bubbling Under Hot 100)". Billboard.
	Billboardchristianairplay	225	US Christian Airplay	Billboard	artist	"{artist} Chart History (Christian Airplay)". Billboard.
	Billboardchristiansongs	391	US Hot Christian Songs	Billboard	artist	"{artist} Chart History (Hot Christian Songs)". Billboard.
	Billboardcountryairplay	1130	US Country Airplay	Billboard	artist	"{artist} Chart History (Country Airplay)". Billboard.
	Billboardcountrysongs	6182	US Hot Country Songs	Billboard	artist	"{artist} Chart History (Hot Country Songs)". Billboard.
	Billboarddanceairplay	935	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	1092	US Hot Dance/Electronic Songs	Billboard	artist	"{artist} Chart History (Hot Dance/Electronic Songs)". Billboard.
	Billboarddancepop	45	US Hot Dance/Pop Songs	Billboard	artist	"{artist} Chart History (Hot Dance/Pop Songs)". Billboard.
	Billboarddancesales	896	US Dance Singles Sales	Billboard	artist	"{artist} Chart History (Dance Singles Sales)". Billboard.
	Billboarddigitalsongs	404	US Digital Song Sales	Billboard	artist	"{artist} Chart History (Digital Song Sales)". Billboard.
	Billboardhardrock	13	US Hot Hard Rock Songs	Billboard	artist	"{artist} Chart History (Hot Hard Rock Songs)". Billboard.
	Billboardhot100	12992	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	531	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	4	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	14	US Hot Latin Rhythm Songs	Billboard	artist	"{artist} Chart History (Hot Latin Rhythm Songs)". Billboard.
	Billboardlatinsongs	1280	US Hot Latin Songs	Billboard	artist	"{artist} Chart History (Hot Latin Songs)". Billboard.
	Billboardmainstreamrock	1915	US Mainstream Rock	Billboard	artist	"{artist} Chart History (Mainstream Rock)". Billboard.
	Billboardpopsongs	3747	US Pop Airplay	Billboard	artist	"{artist} Chart History (Pop Songs)". Billboard.
	Billboardradiosongs	279	US Radio Songs	Billboard	artist	"{artist} Chart History (Radio Songs)". Billboard.
	Billboardrandbhiphop	5861	US Hot R&B/Hip-Hop Songs	Billboard	artist	"{artist} Chart History (Hot R&B/Hip-Hop Songs)". Billboard.
	Billboardrandbhiphopairplay	499	US R&B/Hip-Hop Airplay	Billboard	artist	"{artist} Chart History (R&B/Hip-Hop Airplay)". Billboard.
	Billboardrandbsongs	6	US Hot R&B Songs	Billboard	artist	"{artist} Chart History (Hot R&B Songs)". Billboard.
	Billboardrapsongs	1268	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	3314	US Rhythmic Airplay	Billboard	artist	"{artist} Chart History (Rhythmic Airplay)". Billboard.
	Billboardrockairplay	902	US Rock & Alternative Airplay	Billboard	artist	"{artist} Chart History (Rock & Alternative Airplay)". Billboard.
	Billboardrocksongs	1811	US Hot Rock & Alternative Songs	Billboard	artist	"{artist} Chart History (Hot Rock & Alternative Songs)". Billboard.
	Billboardsinglessales (defunct)	8	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	404	US Tropical Airplay	Billboard	artist	"{artist} Chart History (Tropical Airplay)". Billboard.
	Billboardtropicalsongs2	4	US Hot Tropical Songs	Billboard	artist	"{artist} Chart History (Hot Tropical Songs)". Billboard.
Uruguay	Uruguay	12	Uruguay Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Uruguay música". Monitor Latino.
	Uruguay Anglo	27	Uruguay Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Uruguay Anglo música". Monitor Latino.
Venezuela	Venezuela	1	Venezuela Airplay	Monitor Latino	date [YYYYMMDD]	"Top 20 Venezuela música". Monitor Latino.
	Venezuela Anglo	29	Venezuela Anglo Airplay	Monitor Latino	date [YYYYMMDD]	"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) WARNING: Unused parameters for "Australia": week.

5

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 (190) – contains subcategories for each chart ID
• Category:Single chart making named ref (9,821) – template created a named reference
• Category:Single chart used with defunct chart (4,581) – chart marked as no longer active
• Category:Single chart called without artist (19,793) – artist parameter not provided
• Category:Single chart called without song (33,278) – song parameter not provided
• Category:Single chart using manual ref mode (4) – 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 (116) – 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 (3,203) – 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.

Parameter		Description	Type	Status
Chart	1	Chart identifier. Must match one of the supported charts (e.g., Australia, Billboardhot100)	String	required
Position	2	Peak or year-end position on the chart. Use en-dash (–) if not charted	Number	required
Manual mode	3	Set to M for manual reference mode (requires url and title)	String	optional
Artist	artist	Artist name as listed on chart. German charts typically require lastname,firstname format. Used for URL construction and default reference naming	String	suggested
Song	song	Song title as listed on chart (single charts only)	String	optional
Album	album	Album title as listed on chart (album charts only)	String	optional
DVD	dvd	DVD title for Music DVD charts. Use instead of album parameter	String	optional
Artist ID	artistid	Numeric artist identifier from chart website URL	Number	optional
Song ID	songid	Numeric song/album identifier from chart website URL	Number	optional
Chart ID	chartid	Numeric chart/archive identifier from URL	Number	optional
ID	id	Alias for chartid	Number	optional
Year	year	Four-digit year. Required for year-end charts; used with week parameter for some weekly charts	Number	optional
Week	week	Week number 1–53 (1–2 digits) or combined format like 51+52	String	optional
Date	date	Chart date for URL construction. Format varies by chart (YYYYMMDD, YYYY-MM-DD, etc.). Not displayed in reference	String	optional
Start date	startdate	Chart week start date. Used only for FlandersMV, WalloniaMV, ItalyMV	String	deprecated
End date	enddate	Chart week end date. Used only for FlandersMV, WalloniaMV, ItalyMV	String	deprecated
URL	url	User-provided URL for charts without automatic indexing, or for manual mode	URL	optional
Title	title	Source title (required for manual mode)	String	optional
Work	work	Publication name (manual mode only)	String	optional
Publisher	publisher	Publisher name (manual mode only)	String	optional
Location	location	Publication location (manual mode only)	String	optional
Page	page	Page number for book sources. Used only with AustraliaKent	Number	optional
Publish date	publish-date publishdate	Chart publication date for display in reference. Used for year-end charts	Date	optional
Access date	access-date accessdate	Date when source was verified by editor	Date	suggested
Archive URL	archive-url archiveurl	URL of archived version of the source	URL	optional
Archive date	archive-date archivedate	Date when the source was archived	Date	optional
URL status	url-status	Status of the URL: live or dead (manual mode only)	String	optional
Ref name	refname	Custom reference name. Default format: sc_Chart_artist or year-end_Chart_year	String	optional
Ref group	refgroup	Reference group name	String	optional
Row header	rowheader	Set to true to output chart name as row header (recommended for accessibility) Default false	Boolean	suggested
Note	note	Note displayed after chart name (e.g., remix version, deluxe edition, then called X)	String	optional

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.