Template:Single chart/doc

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

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

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 (Official Charts)	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= |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

Group	Chart ID	Uses	Chart	Provider	Required params	Template call	Sample ref output	Notes
Argentina	Argentina Anglo	66	Argentina Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Argentina Anglo|0|date=}}	"Top 20 Argentina Anglo música". Monitor Latino.	Data from June 6, 2016.
	Argentina ML	40	Argentina Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Argentina ML|0|date=}}	"Top 20 Argentina música". Monitor Latino.
	Billboardargentinahot100	522	Argentina Hot 100	Billboard	artist	{{Single chart|Billboardargentinahot100|0|artist=}}	"{artist} Chart History (Argentina Hot 100)". Billboard.
Australia	Australia	7032	Australia	ARIA	artist, song	{{Single chart|Australia|0|artist=|song=}}	"{artist} – {song}". ARIA Top 50 Singles.
	AustraliaKent	28	Australia	Kent Music Report	page	{{Single chart|AustraliaKent|0|page=}}	{{cite Kent|page=42}}.
	Australiadance	157	Australian Dance	ARIA	url	{{Single chart|Australiadance|0|url=}}	"[{url} The ARIA Report, Issue ]". ARIA Top 50 Dance Singles. National Library of Australia.
	Australiapandora	439	Australia	ARIA	url	{{Single chart|Australiapandora|0|url=}}	"[{url} The ARIA Report, Issue ]". ARIA Top 100 Singles. National Library of Australia.
	Australiaurban	528	Australian Urban	ARIA	url	{{Single chart|Australiaurban|0|url=}}	"[{url} The ARIA Report, Issue ]". ARIA Top 40 Urban Singles. National Library of Australia.
Austria	Austria	6771	Austria	Ö3 Austria Top 40	artist, song	{{Single chart|Austria|0|artist=|song=}}	"{artist} – {song}" (in German). Ö3 Austria Top 40.
Belarus	Belarus	116	Belarus Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Belarus|0|date=}}	"Top Radio Hits Belarus Weekly Chart". TopHit.
Belgium	Flanders	7091	Belgium	Ultratop 50 Flanders	artist, song	{{Single chart|Flanders|0|artist=|song=}}	"{artist} – {song}" (in Dutch). Ultratop 50.
	Flanders Dance	270	Belgium Dance	Ultratop Flanders	artist, song	{{Single chart|Flanders Dance|0|artist=|song=}}	"{artist} – {song}" (in Dutch). Ultratop Dance.
	Flanders Tip	3263	Belgium	Ultratip Bubbling Under Flanders	artist, song	{{Single chart|Flanders Tip|0|artist=|song=}}	"{artist} – {song}" (in Dutch). Ultratip.
	Flanders Urban	205	Belgium Urban	Ultratop Flanders	artist, song	{{Single chart|Flanders Urban|0|artist=|song=}}	"{artist} – {song}" (in Dutch). Ultratop Urban.
	Wallonia	3979	Belgium	Ultratop 50 Wallonia	artist, song	{{Single chart|Wallonia|0|artist=|song=}}	"{artist} – {song}" (in French). Ultratop 50.
	Wallonia Dance	168	Belgium Dance	Ultratop Wallonia	artist, song	{{Single chart|Wallonia Dance|0|artist=|song=}}	"{artist} – {song}" (in French). Ultratop Dance.
	Wallonia Tip	2410	Belgium	Ultratip Bubbling Under Wallonia	artist, song	{{Single chart|Wallonia Tip|0|artist=|song=}}	"{artist} – {song}" (in French). Ultratip.
Bolivia	Bolivia	47	Bolivia Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Bolivia|0|date=}}	"Top 20 Bolivia música". Monitor Latino.	Data from August 21, 2017.
	Bolivia Anglo	64	Bolivia Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Bolivia Anglo|0|date=}}	"Top 20 Bolivia Anglo música". Monitor Latino.
Brazil	Brazil (defunct)	29	Brazil Hot 100 Airplay	Billboard Brasil	—	{{Single chart|Brazil|0}}	(no url)
	Brazil2	189	Brazil Hot 100	Billboard	artist	{{Single chart|Brazil2|0|artist=}}	"{artist} Chart History (Brasil Hot 100)". Billboard.	Data from September 2, 2023.
Bulgaria	Bulgaria	48	Bulgaria Airplay	BAMP	url	{{Single chart|Bulgaria|0|url=}}	"[{url} Airplay Top 5 – ]". Bulgarian Association of Music Producers.
CIS	CIS	1506	CIS Airplay	TopHit	songid	{{Single chart|CIS|0|songid=}}	"Charts – TopHit – Highway to Airplay". TopHit.
Canada	Billboardcanadaac	737	Canada AC	Billboard	artist	{{Single chart|Billboardcanadaac|0|artist=}}	"{artist} Chart History (Canada AC)". Billboard.
	Billboardcanadachrtop40	1268	Canada CHR/Top 40	Billboard	artist	{{Single chart|Billboardcanadachrtop40|0|artist=}}	"{artist} Chart History (Canada CHR/Top 40)". Billboard.
	Billboardcanadacountry	1330	Canada Country	Billboard	artist	{{Single chart|Billboardcanadacountry|0|artist=}}	"{artist} Chart History (Canada Country)". Billboard.
	Billboardcanadahotac	1114	Canada Hot AC	Billboard	artist	{{Single chart|Billboardcanadahotac|0|artist=}}	"{artist} Chart History (Canada Hot AC)". Billboard.
	Billboardcanadarock	735	Canada Rock	Billboard	artist	{{Single chart|Billboardcanadarock|0|artist=}}	"{artist} Chart History (Canada Rock)". Billboard.
	Billboardcanadianhot100	738	Canada Hot 100	Billboard	artist	{{Single chart|Billboardcanadianhot100|0|artist=}}	"{artist} Chart History (Canadian Hot 100)". Billboard.
	Canada	5681	→ Billboardcanadianhot100
	Canada RPM	80	Canada Top Singles	RPM	chartid	{{Single chart|Canada RPM|0|chartid=}}	"Top Singles. Volume 1, Issue 1 (2024-01-15)". RPM. Library and Archives Canada.	Use the IdNumber from the URL (RPM search). Data from February 11, 1964 to November 6, 2000.
	Canada RPM AC	37	Canada Adult Contemporary	RPM	chartid	{{Single chart|Canada RPM AC|0|chartid=}}	"Adult Contemporary. Volume 1, Issue 1 (2024-01-15)". RPM. Library and Archives Canada.	Use the IdNumber from the URL (RPM search). Data from January 11, 1965 to November 6, 2000.
	Canada RPM Country	29	Canada Country Singles	RPM	chartid	{{Single chart|Canada RPM Country|0|chartid=}}	"Country Singles. Volume 1, Issue 1 (2024-01-15)". RPM. Library and Archives Canada.	Use the IdNumber from the URL (RPM search). Data from September 14, 1964 to November 6, 2000.
	Canada RPM Dance	13	Canada Dance/Urban	RPM	chartid	{{Single chart|Canada RPM Dance|0|chartid=}}	"Dance/Urban. Volume 1, Issue 1 (2024-01-15)". RPM. Library and Archives Canada.	Use the IdNumber from the URL (RPM search). Data from November 13, 1976 to October 16, 2000.
	Canada RPM Rock	2	Canada Rock/Alternative	RPM	chartid	{{Single chart|Canada RPM Rock|0|chartid=}}	"Rock/Alternative. Volume 1, Issue 1 (2024-01-15)". RPM. Library and Archives Canada.	Use the IdNumber from the URL (RPM search). Data from November 10, 1973 to November 6, 2000.
	Canadaadultcontemporary (defunct)	1332	Canada Adult Contemporary	RPM	chartid	{{Single chart|Canadaadultcontemporary|0|chartid=}}	"Top RPM Adult Contemporary: Image 12345". RPM. Library and Archives Canada. {{dead link|date=July 2026}}	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 (defunct)	1791	Canada Country Tracks	RPM	chartid	{{Single chart|Canadacountry|0|chartid=}}	"Top RPM Country Tracks: Image 12345". RPM. Library and Archives Canada. {{dead link|date=July 2026}}
	Canadadance (defunct)	560	Canada Dance/Urban	RPM	chartid	{{Single chart|Canadadance|0|chartid=}}	"Top RPM Dance/Urban: Image 12345". RPM. Library and Archives Canada. {{dead link|date=July 2026}}
	Canadamainstreamrock	50	Canada Mainstream Rock	Billboard Canada	date [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.
	Canadamodernrock	54	Canada Modern Rock	Billboard Canada	date [YYYY-MM-DD]	{{Single chart|Canadamodernrock|0|date=}}	"Canada Modern Rock for the week of January 15, 2024". Billboard Canada.
	Canadarock (defunct)	345	Canada Rock/Alternative	RPM	chartid	{{Single chart|Canadarock|0|chartid=}}	"Top RPM Rock/Alternative Tracks: Image 12345". RPM. Library and Archives Canada. {{dead link|date=July 2026}}	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 (defunct)	3348	Canada Top Singles	RPM	chartid	{{Single chart|Canadatopsingles|0|chartid=}}	"Top RPM Singles: Image 12345". RPM. Library and Archives Canada. {{dead link|date=July 2026}}
Central America	Central America	13	Central America Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Central America|0|date=}}	"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	89	Central America Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Central America Anglo|0|date=}}	"Top 20 Centroamérica Anglo música". Monitor Latino.
Chile	Chile	46	Chile Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Chile|0|date=}}	"Top 20 Chile música". Monitor Latino.	Data from May 2, 2016.
	Chile Anglo	57	Chile Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Chile Anglo|0|date=}}	"Top 20 Chile Anglo música". Monitor Latino.
Colombia	Billboardcolombiahot100	29	Colombia Hot 100	Billboard	artist	{{Single chart|Billboardcolombiahot100|0|artist=}}	"{artist} Chart History (Colombia Hot 100)". Billboard.
	Colombia	5	Colombia Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Colombia|0|date=}}	"Top 20 Colombia música". Monitor Latino.
	Colombia Anglo	68	Colombia Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Colombia Anglo|0|date=}}	"Top 20 Colombia Anglo música". Monitor Latino.
Costa Rica	Costa Rica	25	Costa Rica Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Costa Rica|0|date=}}	"Top 20 Costa Rica música". Monitor Latino.
	Costa Rica Anglo	85	Costa Rica Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Costa Rica Anglo|0|date=}}	"Top 20 Costa Rica Anglo música". Monitor Latino.
Czech Republic	Czech Republic	2168	Czech Republic Airplay	ČNS IFPI	week, 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.
	Czechdigital	1859	Czech Republic Singles Digital	ČNS IFPI	week, 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.
Denmark	Denmark → year, week	2328	Denmark	Tracklisten	year, week	{{Single chart|Denmark|0|year=|week=}}	"Track Top-40 – Hitlisten.NU – Danmarks officielle hitlister" (in Danish). Tracklisten.	Data from 2007.
	Denmark → artist, song				artist, song	{{Single chart|Denmark|0|artist=|song=}}	"{artist} – {song}". Tracklisten.	Data from 2001. May vary from official positions for older songs.
	Denmark Airplay	152	Denmark Airplay	Tracklisten	week, year	{{Single chart|Denmark Airplay|0|week=|year=}}	"Airplay Top-20 – Hitlisten.NU – Danmarks officielle hitlister" (in Danish). Tracklisten.
Dominican Republic	Dominican Republic	8	Dominican Republic Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Dominican Republic|0|date=}}	"Top 20 República Dominicana música". Monitor Latino.
	Dominican Republic Anglo	85	Dominican Republic Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Dominican Republic Anglo|0|date=}}	"Top 20 República Dominicana Anglo música". Monitor Latino.
Ecuador	Ecuador	18	Ecuador Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Ecuador|0|date=}}	"Top 20 Ecuador música". Monitor Latino.
	Ecuador Anglo	91	Ecuador Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Ecuador Anglo|0|date=}}	"Top 20 Ecuador Anglo música". Monitor Latino.
El Salvador	El Salvador	17	El Salvador Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|El Salvador|0|date=}}	"Top 20 El Salvador música". Monitor Latino.	Data from August 21, 2017.
	El Salvador Anglo	56	El Salvador Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|El Salvador Anglo|0|date=}}	"Top 20 El Salvador Anglo música". Monitor Latino.
Estonia	Estonia	283	Estonia Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Estonia|0|date=}}	"Top Radio Hits Estonia Weekly Chart". TopHit.
Europe	Billboardeurodigital	500	Euro Digital Song Sales	Billboard	artist	{{Single chart|Billboardeurodigital|0|artist=}}	"{artist} Chart History (Euro Digital Song Sales)". Billboard.
	Billboardeuropeanhot100 (defunct)	180	European Hot 100 Singles	Billboard	artist	{{Single chart|Billboardeuropeanhot100|0|artist=}}	"{artist} Chart History (European Hot 100 Singles)". Billboard. Archived from the original. {{dead link|date=November 2021}}
Finland	Finland	2394	Finland	Suomen virallinen lista	artist, song	{{Single chart|Finland|0|artist=|song=}}	"{artist}: {song}" (in Finnish). Musiikkituottajat.
	Finland2	3	Finland	Suomen virallinen lista	artist, song	{{Single chart|Finland2|0|artist=|song=}}	"{artist} – {song}" (in French). Musiikkituottajat.
	Finnishairplay	358	Finland Airplay	Radiosoittolista	artist, 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.
	Finnishdownload	170	Finland Download	Latauslista	artist, 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.
France	France	6006	France	SNEP	artist, song	{{Single chart|France|0|artist=|song=}}	"{artist} – {song}" (in French). Le classement de singles.
	Frenchdigital	29	France Download	SNEP	date [YYYYMMDD]	{{Single chart|Frenchdigital|0|date=}}	"lescharts.com – Français" (in French). Le classement des téléchargements de singles.
Germany	Germany	8171	Germany	GfK	year, 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 Germany	1739	West Germany	GfK	year, 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.
Global	Billboardglobal200	2614	Global 200	Billboard	artist	{{Single chart|Billboardglobal200|0|artist=}}	"{artist} Chart History (Global 200)". Billboard.
Guatemala	Guatemala	39	Guatemala Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Guatemala|0|date=}}	"Top 20 Guatemala música". Monitor Latino.	Data from December 14, 2015.
	Guatemala Anglo	87	Guatemala Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Guatemala Anglo|0|date=}}	"Top 20 Guatemala Anglo música". Monitor Latino.
Honduras	Honduras	13	Honduras Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Honduras|0|date=}}	"Top 20 Honduras música". Monitor Latino.	Data from November 20, 2017.
	Honduras Anglo	74	Honduras Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Honduras Anglo|0|date=}}	"Top 20 Honduras Anglo música". Monitor Latino.
Hungary	Hungary	1321	→ Hungaryradio
	Hungarydance	853	Hungary	Dance Top 40	year, 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.
	Hungaryradio	405	Hungary	Rádiós Top 40	year, 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.
	Hungarysingle	2157	Hungary	Single Top 40	year, 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.
	Hungarystream	768	Hungary	Stream Top 40	year, 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.
India	India Int	50	India International	IMI	week, year	{{Single chart|India Int|0|week=|year=}}	"Week 3 – 2024 – IMI Charts". IMI.	Data from week 24 of 2021. Use the year and week shown in the IMI archive.
Ireland	Ireland (defunct)	1157	Ireland	IRMA	year, week	{{Single chart|Ireland|0|year=|week=}}	"Chart Track: Week 3, 2024". Irish Singles Chart. Archived from the original. {{dead link|date=March 2019}}	Week 1–53, no leading zero. Data 2000–2016.
	Ireland2 → artist	5974	Ireland	IRMA	artist	{{Single chart|Ireland2|0|artist=}}	"{artist} | IRMA". Irish Singles Chart.	Links to search results page.
	Ireland2 → song				song	{{Single chart|Ireland2|0|song=}}	"{song} | IRMA". Irish Singles Chart.
	Ireland3	1671	Ireland	IRMA	artist	{{Single chart|Ireland3|0|artist=}}	"Irish-charts.com – Discography {artist}". Irish Singles Chart.	Links to the artist's discography.
	Ireland4 → date	1247	Ireland	IRMA	date [YYYYMMDD]	{{Single chart|Ireland4|0|date=}}	"Official Irish Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
	Ireland4 → artist, song				artist, song	{{Single chart|Ireland4|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	Ireland5	29	Ireland	IRMA	date [YYYY-MM-DD]	{{Single chart|Ireland5|0|date=}}	"History of Top 100 Singles Charts (2024-01-15) – IRMA". Irish Singles Chart.	Data starting from November 6, 2014.
Israel	Israel International	205	Israel International Airplay	Media Forest	week, 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)	247	Israel International Airplay	Media Forest	year, 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.
Italy	Italy	2572	Italy	FIMI	artist, song	{{Single chart|Italy|0|artist=|song=}}	"{artist} – {song}". Top Digital Download.
	ItalyFIMI	130	Italy	FIMI	year, week	{{Single chart|ItalyFIMI|0|year=|week=}}	"Singoli 3 2024 – Archivio classifiche settimanali". Federazione Industria Musicale Italiana.
Japan	Billboardjapanhot100	930	Japan Hot 100	Billboard	artist	{{Single chart|Billboardjapanhot100|0|artist=}}	"{artist} Chart History (Japan Hot 100)". Billboard.
	Oricon → date<2021-03-15	92	Japan	Oricon	date [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-15				date [YYYY-MM-DD]	{{Single chart|Oricon|0|date=}}	"Oricon Weekly Single Ranking – 2024-01-15". Oricon News.
	Oricon2	77	Japan	Oricon	artistid, 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/.
Kazakhstan	Kazakhstan	179	Kazakhstan Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Kazakhstan|0|date=}}	"Top Radio Hits Kazakhstan Weekly Chart". TopHit.
Latvia	Latvia	51	Latvia Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Latvia|0|date=}}	"Top Radio Hits Latvia Weekly Chart". TopHit.
Lithuania	Lithuania	164	Lithuania Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Lithuania|0|date=}}	"Top Radio Hits Lithuania Weekly Chart". TopHit.
Luxembourg	Luxembourgdigitalsongs (defunct)	83	Luxembourg Digital Song Sales	Billboard	artist	{{Single chart|Luxembourgdigitalsongs|0|artist=}}	"{artist} Chart History (Luxembourg Digital Song Sales)". Billboard. Archived from the original. {{dead link|date=November 2021}}
Mexico	Billboard Mexico	16	Mexico Airplay	Billboard	artist	{{Single chart|Billboard Mexico|0|artist=}}	"{artist} Chart History (Mexico Airplay)". Billboard.
	Billboard Mexico Ingles	4	Mexico Ingles Airplay	Billboard	artist	{{Single chart|Billboard Mexico Ingles|0|artist=}}	"{artist} Chart History (Mexico Ingles Airplay)". Billboard.
	Mexico Anglo	83	Mexico Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Mexico Anglo|0|date=}}	"Top 20 México Anglo música". Monitor Latino.
	Mexico ML	23	Mexico Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Mexico ML|0|date=}}	"Top 20 México música". Monitor Latino.
Moldova	Moldova	145	Moldova Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Moldova|0|date=}}	"Top Radio Hits Moldova Weekly Chart". TopHit.
Netherlands	Dutch100	10021	Netherlands	Single Top 100	artist, song	{{Single chart|Dutch100|0|artist=|song=}}	"{artist} – {song}" (in Dutch). Single Top 100.
	Dutch40 → year, week	6337	Netherlands	Dutch Top 40	year, 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 → artist				artist	{{Single chart|Dutch40|0|artist=}}	"Nederlandse Top 40 – {artist}" (in Dutch). Dutch Top 40.	Links to search results page.
New Zealand	New Zealand	7189	New Zealand	Recorded Music NZ	artist, song	{{Single chart|New Zealand|0|artist=|song=}}	"{artist} – {song}". Top 40 Singles.
Nicaragua	Nicaragua	17	Nicaragua Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Nicaragua|0|date=}}	"Top 20 Nicaragua música". Monitor Latino.	Data from November 27, 2017.
	Nicaragua Anglo	104	Nicaragua Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Nicaragua Anglo|0|date=}}	"Top 20 Nicaragua Anglo música". Monitor Latino.
Norway	Norway → year, week	3678	Norway	VG-lista	year, 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, song				artist, song	{{Single chart|Norway|0|artist=|song=}}	"{artist} – {song}". VG-lista.
Panama	Panama	33	Panama Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Panama|0|date=}}	"Top 20 Panamá música". Monitor Latino.	Data from December 5, 2016.
	Panama Anglo	65	Panama Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Panama Anglo|0|date=}}	"Top 20 Panamá Anglo música". Monitor Latino.
Paraguay	Paraguay	49	Paraguay Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Paraguay|0|date=}}	"Top 20 Paraguay música". Monitor Latino.	Data from February 27, 2017.
	Paraguay Anglo	60	Paraguay Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Paraguay Anglo|0|date=}}	"Top 20 Paraguay Anglo música". Monitor Latino.
Peru	Peru	31	Peru Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Peru|0|date=}}	"Top 20 Perú música". Monitor Latino.
	Peru Anglo	68	Peru Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Peru Anglo|0|date=}}	"Top 20 Perú Anglo música". Monitor Latino.
Philippines	Philippines	140	Philippines Hot 100	Billboard Philippines	date [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 Songs	17	Philippines Top Songs	Billboard Philippines	date [MM-DD-YYYY]	{{Single chart|Philippines Top Songs|0|date=}}	"Top Philippine Songs – Week of January 15, 2024". Billboard Philippines.
Poland	Poland (defunct)	1116	Poland Airplay	ZPAV	year, 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=).
	Poland Streaming	0	Poland Streaming	OLiS	date [DD.MM.YYYY]	{{Single chart|Poland Streaming|0|date=}}	"OLiS - oficjalna lista sprzedaży - single w streamie" (in Polish). OLiS. Note: Change the date to 15.01.2024 under "zmień zakres od–do:" on the left.	Use the week start date shown in the list on the left.
	Poland2	28	Poland Airplay	OLiS	date [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:" on the left.
	Polishdance	325	Poland Dance	ZPAV	chartid	{{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.
Portugal	Portugal	2141	Portugal	AFP	artist, song	{{Single chart|Portugal|0|artist=|song=}}	"{artist} – {song}". AFP Top 100 Singles.
	Portugalairplay	60	Portugal Airplay	AFP	chartid	{{Single chart|Portugalairplay|0|chartid=}}	"TOP 100 - Lista". Audiogest.
	Portugaldigitalsongs (defunct)	66	Portugal Digital Song Sales	Billboard	artist	{{Single chart|Portugaldigitalsongs|0|artist=}}	"{artist} Chart History (Portugal Digital Song Sales)". Billboard. Archived from the original. {{dead link|date=November 2021}}
Puerto Rico	Puerto Rico	25	Puerto Rico Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Puerto Rico|0|date=}}	"Top 20 Puerto Rico música". Monitor Latino.	Data from August 13, 2018.
	Puerto Rico Anglo	52	Puerto Rico Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Puerto Rico Anglo|0|date=}}	"Top 20 Puerto Rico Anglo música". Monitor Latino.
Romania	Romaniaradioairplay	246	Romania Airplay	Media Forest	year, 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.
	Romaniatvairplay	158	Romania TV Airplay	Media Forest	year, 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.
Russia	Russiaradio	708	Russia Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Russiaradio|0|date=}}	"Top Radio Hits Russia Weekly Chart". TopHit.
Slovakia	Slovakdigital (defunct) → year+week<=2016+34	381	Slovakia Singles Digital	ČNS IFPI	year, 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+34				year, 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.
	Slovakdigital2	1409	Slovakia Singles Digital	ČNS IFPI	week, 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+34	1185	Slovakia Airplay	ČNS IFPI	year, 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+34				year, 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.
	Slovakia2	964	Slovakia Airplay	ČNS IFPI	week, 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 Africa	South Africa (defunct)	151	South Africa Airplay	EMA	date [YYYY-MM-DD]	{{Single chart|South Africa|0|date=}}	"EMA Top 10 Airplay: Week Ending 2024-01-15". Entertainment Monitoring Africa.
	South Africa2 → year=2021	263	South Africa Streaming	TOSAC	year, 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 Africa2				week, year	{{Single chart|South Africa2|0|week=|year=}}	"Local & International Streaming Chart Top 10 Week 3-2024". The Official South African Charts.
Spain	Spain	2314	Spain	Promusicae	artist, song	{{Single chart|Spain|0|artist=|song=}}	"{artist} – {song}". Canciones Top 50.
Sweden	Sweden	6382	Sweden	Sverigetopplistan	artist, song	{{Single chart|Sweden|0|artist=|song=}}	"{artist} – {song}". Singles Top 100.
Switzerland	Swiss Romandy	50	Switzerland	Media Control Romandy	artist, song	{{Single chart|Swiss Romandy|0|artist=|song=}}	"{artist} – {song}" (in French). Media Control.
	Switzerland	8392	Switzerland	Schweizer Hitparade	artist, song	{{Single chart|Switzerland|0|artist=|song=}}	"{artist} – {song}". Swiss Singles Chart.
Ukraine	Ukraineradio	566	Ukraine Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	{{Single chart|Ukraineradio|0|date=}}	"Top Radio Hits Ukraine Weekly Chart". TopHit.
United Kingdom	Scotland → date	7949	Scottish Singles Sales	Official Charts	date [YYYYMMDD]	{{Single chart|Scotland|0|date=}}	"Official Scottish Singles Sales Chart on 15/1/2024 – Top 100". Official Charts Company.	Data from March 13, 1994 to December 10, 2020.
	Scotland → artist, song				artist, song	{{Single chart|Scotland|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UK → date	12806	UK Singles	Official Charts	date [YYYYMMDD]	{{Single chart|UK|0|date=}}	"Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.
	UK → artist, song				artist, song	{{Single chart|UK|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKZobbel	68	UK Singles	Official Charts	date [YYMMDD]	{{Single chart|UKZobbel|0|date=}}	"Chart Log UK: 15.01.2011". UK singles chart. Zobbel.de.
	UKafrobeats → date	91	UK Afrobeats	Official Charts	date [YYYYMMDD]	{{Single chart|UKafrobeats|0|date=}}	"Official Afrobeats Chart on 15/1/2024 – Top 20". Official Charts Company.
	UKafrobeats → artist, song				artist, song	{{Single chart|UKafrobeats|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKdance → date	1728	UK Dance	Official Charts	date [YYYYMMDD]	{{Single chart|UKdance|0|date=}}	"Official Dance Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
	UKdance → artist, song				artist, song	{{Single chart|UKdance|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKdownload → date	781	UK Singles Downloads	Official Charts	date [YYYYMMDD]	{{Single chart|UKdownload|0|date=}}	"Official Singles Downloads Chart on 15/1/2024 – Top 100". Official Charts Company.
	UKdownload → artist, song				artist, song	{{Single chart|UKdownload|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKindependent	100	→ UKindie
	UKindie → date	1317	UK Indie	Official Charts	date [YYYYMMDD]	{{Single chart|UKindie|0|date=}}	"Official Independent Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
	UKindie → artist, song				artist, song	{{Single chart|UKindie|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKphysical → date	15	UK Physical Singles	Official Charts	date [YYYYMMDD]	{{Single chart|UKphysical|0|date=}}	"Official Physical Singles Chart on 15/1/2024". Official Charts Company.
	UKphysical → artist, song				artist, song	{{Single chart|UKphysical|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKrandb → date	2620	UK Hip Hop/R&B	Official Charts	date [YYYYMMDD]	{{Single chart|UKrandb|0|date=}}	"Official Hip Hop and R&B Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
	UKrandb → artist, song				artist, song	{{Single chart|UKrandb|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKrock → date	720	UK Rock & Metal	Official Charts	date [YYYYMMDD]	{{Single chart|UKrock|0|date=}}	"Official Rock & Metal Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
	UKrock → artist, song				artist, song	{{Single chart|UKrock|0|artist=|song=}}	"{song} – {artist} | Official Charts". Official Charts Company.	Links directly to a song's chart history.
	UKsinglesbyname → artistid	3955	UK Singles	Official Charts	artistid, artist	{{Single chart|UKsinglesbyname|0|artistid=|artist=}}	"{artist} Songs and Albums | Full Official Chart History". Official Charts Company.
	UKsinglesbyname → artist				artist	{{Single chart|UKsinglesbyname|0|artist=}}	"Search results for "{artist}" | Official Chart". Official Charts Company.	Links to search results page. Use artistid for direct link.
	UKstreaming	182	UK Audio Streaming	Official Charts	date [YYYYMMDD]	{{Single chart|UKstreaming|0|date=}}	"Official Audio Streaming Chart on 15/1/2024 – Top 100". Official Charts Company.
United States	Billboardadultalternativesongs	774	US Adult Alternative Airplay	Billboard	artist	{{Single chart|Billboardadultalternativesongs|0|artist=}}	"{artist} Chart History (Adult Alternative Airplay)". Billboard.
	Billboardadultcontemporary	3115	US Adult Contemporary	Billboard	artist	{{Single chart|Billboardadultcontemporary|0|artist=}}	"{artist} Chart History (Adult Contemporary)". Billboard.
	Billboardadultpopsongs	2743	US Adult Pop Airplay	Billboard	artist	{{Single chart|Billboardadultpopsongs|0|artist=}}	"{artist} Chart History (Adult Pop Songs)". Billboard.
	Billboardadultrandbsongs	300	US Adult R&B Songs	Billboard	artist	{{Single chart|Billboardadultrandbsongs|0|artist=}}	"{artist} Chart History (Adult R&B Songs)". Billboard.
	Billboardafrobeats	49	US Afrobeats Songs	Billboard	artist	{{Single chart|Billboardafrobeats|0|artist=}}	"{artist} Chart History (Afrobeats Songs)". Billboard.
	Billboardalternativesongs	1911	US Alternative Airplay	Billboard	artist	{{Single chart|Billboardalternativesongs|0|artist=}}	"{artist} Chart History (Alternative Airplay)". Billboard.
	Billboardbubbling100	2361	US Bubbling Under Hot 100	Billboard	artist	{{Single chart|Billboardbubbling100|0|artist=}}	"{artist} Chart History (Bubbling Under Hot 100)". Billboard.
	Billboardchristianairplay	244	US Christian Airplay	Billboard	artist	{{Single chart|Billboardchristianairplay|0|artist=}}	"{artist} Chart History (Christian Airplay)". Billboard.
	Billboardchristiansongs	422	US Hot Christian Songs	Billboard	artist	{{Single chart|Billboardchristiansongs|0|artist=}}	"{artist} Chart History (Hot Christian Songs)". Billboard.
	Billboardcountryairplay	1179	US Country Airplay	Billboard	artist	{{Single chart|Billboardcountryairplay|0|artist=}}	"{artist} Chart History (Country Airplay)". Billboard.
	Billboardcountrysongs	6240	US Hot Country Songs	Billboard	artist	{{Single chart|Billboardcountrysongs|0|artist=}}	"{artist} Chart History (Hot Country Songs)". Billboard.
	Billboarddanceairplay	1012	US Dance Airplay	Billboard	artist	{{Single chart|Billboarddanceairplay|0|artist=}}	"{artist} Chart History (Dance Airplay)". Billboard.
	Billboarddanceclubplay	2580	US Dance Club Songs	Billboard	artist	{{Single chart|Billboarddanceclubplay|0|artist=}}	"{artist} Chart History (Dance Club Songs)". Billboard.
	Billboarddanceelectronic	1114	US Hot Dance/Electronic Songs	Billboard	artist	{{Single chart|Billboarddanceelectronic|0|artist=}}	"{artist} Chart History (Hot Dance/Electronic Songs)". Billboard.
	Billboarddancepop	67	US Hot Dance/Pop Songs	Billboard	artist	{{Single chart|Billboarddancepop|0|artist=}}	"{artist} Chart History (Hot Dance/Pop Songs)". Billboard.
	Billboarddancesales	921	US Dance Singles Sales	Billboard	artist	{{Single chart|Billboarddancesales|0|artist=}}	"{artist} Chart History (Dance Singles Sales)". Billboard.
	Billboarddigitalsongs	439	US Digital Song Sales	Billboard	artist	{{Single chart|Billboarddigitalsongs|0|artist=}}	"{artist} Chart History (Digital Song Sales)". Billboard.
	Billboardhardrock	18	US Hot Hard Rock Songs	Billboard	artist	{{Single chart|Billboardhardrock|0|artist=}}	"{artist} Chart History (Hot Hard Rock Songs)". Billboard.
	Billboardhot100	13327	US Billboard Hot 100	—	artist	{{Single chart|Billboardhot100|0|artist=}}	"{artist} Chart History (Hot 100)". Billboard.
	Billboardhotalternativesongs	5	US Hot Alternative Songs	Billboard	artist	{{Single chart|Billboardhotalternativesongs|0|artist=}}	"{artist} Chart History (Hot Alternative Songs)". Billboard.
	Billboardlatinairplay	542	US Latin Airplay	Billboard	artist	{{Single chart|Billboardlatinairplay|0|artist=}}	"{artist} Chart History (Latin Airplay)". Billboard.
	Billboardlatinpopsongs	641	US Latin Pop Airplay	Billboard	artist	{{Single chart|Billboardlatinpopsongs|0|artist=}}	"{artist} Chart History (Latin Pop Airplay)". Billboard.
	Billboardlatinpopsongs2	10	US Hot Latin Pop Songs	Billboard	artist	{{Single chart|Billboardlatinpopsongs2|0|artist=}}	"{artist} Chart History (Hot Latin Pop Songs)". Billboard.
	Billboardlatinrhythm	293	US Latin Rhythm Airplay	Billboard	artist	{{Single chart|Billboardlatinrhythm|0|artist=}}	"{artist} Chart History (Latin Rhythm Airplay)". Billboard.
	Billboardlatinrhythmsongs2	19	US Hot Latin Rhythm Songs	Billboard	artist	{{Single chart|Billboardlatinrhythmsongs2|0|artist=}}	"{artist} Chart History (Hot Latin Rhythm Songs)". Billboard.
	Billboardlatinsongs	1306	US Hot Latin Songs	Billboard	artist	{{Single chart|Billboardlatinsongs|0|artist=}}	"{artist} Chart History (Hot Latin Songs)". Billboard.
	Billboardmainstreamrock	2015	US Mainstream Rock	Billboard	artist	{{Single chart|Billboardmainstreamrock|0|artist=}}	"{artist} Chart History (Mainstream Rock)". Billboard.
	Billboardpopsongs	3803	US Pop Airplay	Billboard	artist	{{Single chart|Billboardpopsongs|0|artist=}}	"{artist} Chart History (Pop Songs)". Billboard.
	Billboardradiosongs	284	US Radio Songs	Billboard	artist	{{Single chart|Billboardradiosongs|0|artist=}}	"{artist} Chart History (Radio Songs)". Billboard.
	Billboardrandbhiphop	5978	US Hot R&B/Hip-Hop Songs	Billboard	artist	{{Single chart|Billboardrandbhiphop|0|artist=}}	"{artist} Chart History (Hot R&B/Hip-Hop Songs)". Billboard.
	Billboardrandbhiphopairplay	519	US R&B/Hip-Hop Airplay	Billboard	artist	{{Single chart|Billboardrandbhiphopairplay|0|artist=}}	"{artist} Chart History (R&B/Hip-Hop Airplay)". Billboard.
	Billboardrandbsongs	11	US Hot R&B Songs	Billboard	artist	{{Single chart|Billboardrandbsongs|0|artist=}}	"{artist} Chart History (Hot R&B Songs)". Billboard.
	Billboardrapsongs	1279	US Hot Rap Songs	Billboard	artist	{{Single chart|Billboardrapsongs|0|artist=}}	"{artist} Chart History (Hot Rap Songs)". Billboard.
	Billboardregionalmexican	91	US Regional Mexican Airplay	Billboard	artist	{{Single chart|Billboardregionalmexican|0|artist=}}	"{artist} Chart History (Regional Mexican Airplay)". Billboard.
	Billboardregionalmexicansongs	5	US Hot Regional Mexican Songs	Billboard	artist	{{Single chart|Billboardregionalmexicansongs|0|artist=}}	"{artist} Chart History (Hot Regional Mexican Songs)". Billboard.
	Billboardrhythmic	3376	US Rhythmic Airplay	Billboard	artist	{{Single chart|Billboardrhythmic|0|artist=}}	"{artist} Chart History (Rhythmic Airplay)". Billboard.
	Billboardrockairplay	961	US Rock & Alternative Airplay	Billboard	artist	{{Single chart|Billboardrockairplay|0|artist=}}	"{artist} Chart History (Rock & Alternative Airplay)". Billboard.
	Billboardrocksongs	1901	US Hot Rock & Alternative Songs	Billboard	artist	{{Single chart|Billboardrocksongs|0|artist=}}	"{artist} Chart History (Hot Rock & Alternative Songs)". Billboard.
	Billboardsinglessales (defunct)	11	US Hot Singles Sales	Billboard	artist	{{Single chart|Billboardsinglessales|0|artist=}}	"{artist} Chart History (Hot Singles Sales)". Billboard. Archived from the original. {{dead link|date=November 2021}}
	Billboardsmoothjazzsongs	25	US Smooth Jazz Airplay	Billboard	artist	{{Single chart|Billboardsmoothjazzsongs|0|artist=}}	"{artist} Chart History (Smooth Jazz Airplay)". Billboard.
	Billboardtropicalairplay	410	US Tropical Airplay	Billboard	artist	{{Single chart|Billboardtropicalairplay|0|artist=}}	"{artist} Chart History (Tropical Airplay)". Billboard.
	Billboardtropicalsongs2	13	US Hot Tropical Songs	Billboard	artist	{{Single chart|Billboardtropicalsongs2|0|artist=}}	"{artist} Chart History (Hot Tropical Songs)". Billboard.
Uruguay	Uruguay	32	Uruguay Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Uruguay|0|date=}}	"Top 20 Uruguay música". Monitor Latino.
	Uruguay Anglo	67	Uruguay Anglo Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Uruguay Anglo|0|date=}}	"Top 20 Uruguay Anglo música". Monitor Latino.
Venezuela	Venezuela	9	Venezuela Airplay	Monitor Latino	date [YYYYMMDD]	{{Single chart|Venezuela|0|date=}}	"Top 20 Venezuela música". Monitor Latino.
	Venezuela Anglo	70	Venezuela Anglo Airplay	Monitor Latino	date [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 helper lookup value, 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 (204) – contains subcategories for each chart ID
• Category:Single chart making named ref (10,304) – template created a named reference
• Category:Single chart used with defunct chart (8,395) – chart marked as no longer active
• Category:Single chart called without artist (20,556) – artist parameter not provided
• Category:Single chart called without song (34,317) – song parameter not provided
• Category:Single chart using manual ref mode (21) – 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 (34) – position is not a valid number (1–200) or dash
• Category:Pages using single chart with unknown parameters (4) – unrecognized parameters used
• Category:Single chart with unused parameters (864) – parameters provided but not used by chart
• Category:Single chart with unsubstituted parameters (0) – raw {{{param}}} or {placeholder} detected, or a helper rejected an invalid lookup value
• 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

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