Template:Single chart

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

This template is used on approximately 42,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Music chart (sandbox)

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

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

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

Usage

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

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

Template syntax
Full version (copy and paste text below and delete parameters you don't need)
`{{Single chart \|(Chart identifier) \|(Peak position) \|artist= \|artistid= \|song= \|songid= \|chartid= \|url= \|date= \|year= \|week= \|note= \|publish-date= \|access-date= \|refname= \|refgroup= \|rowheader= }}` It is a good practice to always include `song` and `artist`, even though some uses of the template do not require them. This makes it easier to modify the template in the future if there is a change in the archives referenced by the template. In addition, the artist parameter is used by default to name references for reuse elsewhere in the article. `rowheader` defaults to `false`. If set to `true`, the chart name will be output as a header, as indicated by WP:ACCESS#Data tables. In most cases, it should be true.

Output

The template produces:

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

Example

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

Produces:

Australia (ARIA)^[1]	1

^ "Example – Example". ARIA Top 50 Singles.

Reference naming

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

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

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

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

Parameters

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

^ "Example Artist – Example Song". ARIA Top 50 Singles.
^ "Brazil Hot 100". Billboard Brasil. November 2024.
^ "Example Artist – Example Song" (in German). Ö3 Austria Top 40.
^ "Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.

Manual reference mode

Use when:

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

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

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

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

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

Supported charts

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

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

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

Single chart outputs
Group	Chart ID	Uses	Chart	Provider	Required params	Template call	Sample ref output	Notes
Argentina	`Argentina`	12	→ Billboardargentinahot100
	`Argentina Anglo`	43	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`	25	Argentina Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Argentina ML\|0\|date=}}`	"Top 20 Argentina música". Monitor Latino.	Data from June 6, 2016.
	`Billboardargentinahot100`	477	Argentina Hot 100	Billboard	artist	`{{Single chart\|Billboardargentinahot100\|0\|artist=}}`	"{artist} Chart History (Argentina Hot 100)". Billboard.
Australia	`Australia`	6966	Australia	ARIA	artist, song	`{{Single chart\|Australia\|0\|artist=\|song=}}`	"{artist} – {song}". ARIA Top 50 Singles.
	`AustraliaKent`	25	Australia	Kent Music Report	page	`{{Single chart\|AustraliaKent\|0\|page=}}`	{{cite Kent\|page=42}}.
	`Australiadance`	155	Australian Dance	ARIA	url	`{{Single chart\|Australiadance\|0\|url=}}`	"[{url} The ARIA Report, Issue ]". ARIA Top 50 Dance Singles. National Library of Australia.
	`Australiapandora`	417	Australia	ARIA	url	`{{Single chart\|Australiapandora\|0\|url=}}`	"[{url} The ARIA Report, Issue ]". ARIA Top 100 Singles. National Library of Australia.
	`Australiaurban`	527	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`	6696	Austria	Ö3 Austria Top 40	artist, song	`{{Single chart\|Austria\|0\|artist=\|song=}}`	"{artist} – {song}" (in German). Ö3 Austria Top 40.
Belarus	`Belarus`	88	Belarus Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	`{{Single chart\|Belarus\|0\|date=}}`	"Top Radio Hits Belarus Weekly Chart". TopHit.
Belgium	`Flanders`	7034	Belgium	Ultratop 50 Flanders	artist, song	`{{Single chart\|Flanders\|0\|artist=\|song=}}`	"{artist} – {song}" (in Dutch). Ultratop 50.
	`Flanders Dance`	281	Belgium Dance	Ultratop Flanders	artist, song	`{{Single chart\|Flanders Dance\|0\|artist=\|song=}}`	"{artist} – {song}" (in Dutch). Ultratop Dance.
	`Flanders Tip`	3252	Belgium	Ultratip Bubbling Under Flanders	artist, song	`{{Single chart\|Flanders Tip\|0\|artist=\|song=}}`	"{artist} – {song}" (in Dutch). Ultratip.
	`Flanders Urban`	204	Belgium Urban	Ultratop Flanders	artist, song	`{{Single chart\|Flanders Urban\|0\|artist=\|song=}}`	"{artist} – {song}" (in Dutch). Ultratop Urban.
	`Wallonia`	3939	Belgium	Ultratop 50 Wallonia	artist, song	`{{Single chart\|Wallonia\|0\|artist=\|song=}}`	"{artist} – {song}" (in French). Ultratop 50.
	`Wallonia Dance`	167	Belgium Dance	Ultratop Wallonia	artist, song	`{{Single chart\|Wallonia Dance\|0\|artist=\|song=}}`	"{artist} – {song}" (in French). Ultratop Dance.
	`Wallonia Tip`	2399	Belgium	Ultratip Bubbling Under Wallonia	artist, song	`{{Single chart\|Wallonia Tip\|0\|artist=\|song=}}`	"{artist} – {song}" (in French). Ultratip.
Bolivia	`Bolivia`	26	Bolivia Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Bolivia\|0\|date=}}`	"Top 20 Bolivia música". Monitor Latino.	Data from August 21, 2017.
Bolivia	`Bolivia Anglo`	49	Bolivia Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Bolivia Anglo\|0\|date=}}`	"Top 20 Bolivia Anglo música". Monitor Latino.	Data from August 21, 2017.
Brazil	`Brazil` (defunct)	28	Brazil Hot 100 Airplay	Billboard Brasil	—	`{{Single chart\|Brazil\|0}}`	(no url)
Brazil	`Brazil2`	159	Brazil Hot 100	Billboard	artist	`{{Single chart\|Brazil2\|0\|artist=}}`	"{artist} Chart History (Brasil Hot 100)". Billboard.	Data from September 2, 2023.
Bulgaria	`Bulgaria`	44	Bulgaria Airplay	BAMP	url	`{{Single chart\|Bulgaria\|0\|url=}}`	"[{url} Airplay Top 5 – ]". Bulgarian Association of Music Producers.
CIS	`CIS`	1447	CIS Airplay	TopHit	songid	`{{Single chart\|CIS\|0\|songid=}}`	"Charts – TopHit – Highway to Airplay". TopHit.
Canada	`Billboardcanadaac` (defunct)	751	Canada AC	Billboard	artist	`{{Single chart\|Billboardcanadaac\|0\|artist=}}`	"{artist} Chart History (Canada AC)". Billboard. {{dead link\|date=November 2024}}
	`Billboardcanadachrtop40` (defunct)	1281	Canada CHR/Top 40	Billboard	artist	`{{Single chart\|Billboardcanadachrtop40\|0\|artist=}}`	"{artist} Chart History (Canada CHR/Top 40)". Billboard. {{dead link\|date=November 2024}}
	`Billboardcanadacountry` (defunct)	1290	Canada Country	Billboard	artist	`{{Single chart\|Billboardcanadacountry\|0\|artist=}}`	"{artist} Chart History (Canada Country)". Billboard. {{dead link\|date=November 2024}}
	`Billboardcanadahotac` (defunct)	1132	Canada Hot AC	Billboard	artist	`{{Single chart\|Billboardcanadahotac\|0\|artist=}}`	"{artist} Chart History (Canada Hot AC)". Billboard. {{dead link\|date=November 2024}}
	`Billboardcanadarock` (defunct)	732	Canada Rock	Billboard	artist	`{{Single chart\|Billboardcanadarock\|0\|artist=}}`	"{artist} Chart History (Canada Rock)". Billboard. {{dead link\|date=November 2024}}
	`Billboardcanadianhot100`	733	Canada Hot 100	Billboard	artist	`{{Single chart\|Billboardcanadianhot100\|0\|artist=}}`	"{artist} Chart History (Canadian Hot 100)". Billboard.
	`Canada`	5540	→ Billboardcanadianhot100
	`Canadaadultcontemporary`	1362	Canada Adult Contemporary	RPM	chartid	`{{Single chart\|Canadaadultcontemporary\|0\|chartid=}}`	"Top RPM Adult Contemporary: Image 12345". RPM. Library and Archives Canada.	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
	`Canadacountry`	1809	Canada Country Tracks	RPM	chartid	`{{Single chart\|Canadacountry\|0\|chartid=}}`	"Top RPM Country Tracks: Image 12345". RPM. Library and Archives Canada.
	`Canadadance`	574	Canada Dance/Urban	RPM	chartid	`{{Single chart\|Canadadance\|0\|chartid=}}`	"Top RPM Dance/Urban: Image 12345". RPM. Library and Archives Canada.
	`Canadamainstreamrock`	31	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`	32	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`	341	Canada Rock/Alternative	RPM	chartid	`{{Single chart\|Canadarock\|0\|chartid=}}`	"Top RPM Rock/Alternative Tracks: Image 12345". RPM. Library and Archives Canada.	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
	`Canadatopsingles`	3406	Canada Top Singles	RPM	chartid	`{{Single chart\|Canadatopsingles\|0\|chartid=}}`	"Top RPM Singles: Image 12345". RPM. Library and Archives Canada.
Central America	`Central America`	7	Central America Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Central America\|0\|date=}}`	"Top 20 Centroamérica música". Monitor Latino.	Combines Guatemala, El Salvador, Honduras, Nicaragua, Costa Rica, and Panama.
Central America	`Central America Anglo`	63	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`	28	Chile Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Chile\|0\|date=}}`	"Top 20 Chile música". Monitor Latino.	Data from May 2, 2016.
Chile	`Chile Anglo`	39	Chile Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Chile Anglo\|0\|date=}}`	"Top 20 Chile Anglo música". Monitor Latino.	Data from May 2, 2016.
Colombia	`Billboardcolombiahot100`	12	Colombia Hot 100	Billboard	artist	`{{Single chart\|Billboardcolombiahot100\|0\|artist=}}`	"{artist} Chart History (Colombia Hot 100)". Billboard.
	`Colombia`	3	Colombia Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Colombia\|0\|date=}}`	"Top 20 Colombia música". Monitor Latino.
	`Colombia Anglo`	42	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`	14	Costa Rica Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Costa Rica\|0\|date=}}`	"Top 20 Costa Rica música". Monitor Latino.
Costa Rica	`Costa Rica Anglo`	59	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`	2135	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.
Czech Republic	`Czechdigital`	1826	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	2295	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	2295	Denmark	Tracklisten	artist, song	`{{Single chart\|Denmark\|0\|artist=\|song=}}`	"{artist} – {song}". Tracklisten.	Data from 2001. May vary from official positions for older songs.
	`Denmark Airplay`	141	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`	5	Dominican Republic Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Dominican Republic\|0\|date=}}`	"Top 20 República Dominicana música". Monitor Latino.
Dominican Republic	`Dominican Republic Anglo`	64	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`	9	Ecuador Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Ecuador\|0\|date=}}`	"Top 20 Ecuador música". Monitor Latino.
Ecuador	`Ecuador Anglo`	63	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`	9	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	`El Salvador Anglo`	33	El Salvador Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|El Salvador Anglo\|0\|date=}}`	"Top 20 El Salvador Anglo música". Monitor Latino.	Data from August 21, 2017.
Estonia	`Estonia`	209	Estonia Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	`{{Single chart\|Estonia\|0\|date=}}`	"Top Radio Hits Estonia Weekly Chart". TopHit.
Europe	`Billboardeurodigital`	342	Euro Digital Song Sales	Billboard	artist	`{{Single chart\|Billboardeurodigital\|0\|artist=}}`	"{artist} Chart History (Euro Digital Song Sales)". Billboard.
Europe	`Billboardeuropeanhot100` (defunct)	180	European Hot 100 Singles	Billboard	artist	`{{Single chart\|Billboardeuropeanhot100\|0\|artist=}}`	"{artist} Chart History (European Hot 100 Singles)". Billboard. {{dead link\|date=November 2021}}
Finland	`Finland`	2350	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`	266	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`	169	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`	5946	France	SNEP	artist, song	`{{Single chart\|France\|0\|artist=\|song=}}`	"{artist} – {song}" (in French). Le classement de singles.
France	`Frenchdigital`	31	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`	8090	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.
Germany	`West Germany`	1719	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`	2448	Global 200	Billboard	artist	`{{Single chart\|Billboardglobal200\|0\|artist=}}`	"{artist} Chart History (Global 200)". Billboard.
Guatemala	`Guatemala`	28	Guatemala Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Guatemala\|0\|date=}}`	"Top 20 Guatemala música". Monitor Latino.	Data from December 14, 2015.
Guatemala	`Guatemala Anglo`	66	Guatemala Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Guatemala Anglo\|0\|date=}}`	"Top 20 Guatemala Anglo música". Monitor Latino.	Data from December 14, 2015.
Honduras	`Honduras`	7	Honduras Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Honduras\|0\|date=}}`	"Top 20 Honduras música". Monitor Latino.	Data from November 20, 2017.
Honduras	`Honduras Anglo`	48	Honduras Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Honduras Anglo\|0\|date=}}`	"Top 20 Honduras Anglo música". Monitor Latino.	Data from November 20, 2017.
Hungary	`Hungary`	1319	→ Hungaryradio
	`Hungarydance`	801	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`	392	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`	2139	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`	758	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.
Ireland	`Ireland`	1156	Ireland	IRMA	year, week	`{{Single chart\|Ireland\|0\|year=\|week=}}`	"Chart Track: Week 3, 2024". Irish Singles Chart. Archived from the original.	Week 1–53, no leading zero. Data 2000–2016.
	`Ireland2` → artist	5916	Ireland	IRMA	artist	`{{Single chart\|Ireland2\|0\|artist=}}`	"The Irish Charts – Search Results – {artist}". Irish Singles Chart.	Links to search results page.
	`Ireland2` → song	5916	Ireland	IRMA	song	`{{Single chart\|Ireland2\|0\|song=}}`	"The Irish Charts – Search Results – {song}". Irish Singles Chart.	Links to search results page.
	`Ireland3`	1651	Ireland	IRMA	artist	`{{Single chart\|Ireland3\|0\|artist=}}`	"Irish-charts.com – Discography {artist}". Irish Singles Chart.	Links to the artist's discography.
Israel	`Israel International`	151	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.
Israel	`Israelairplay` (defunct)	246	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`	2551	Italy	FIMI	artist, song	`{{Single chart\|Italy\|0\|artist=\|song=}}`	"{artist} – {song}". Top Digital Download.
Italy	`ItalyFIMI`	114	Italy	FIMI	year, week	`{{Single chart\|ItalyFIMI\|0\|year=\|week=}}`	"Singoli 3 2024 – Archivio classifiche settimanali". Federazione Industria Musicale Italiana.
Japan	`Billboardjapanhot100`	908	Japan Hot 100	Billboard	artist	`{{Single chart\|Billboardjapanhot100\|0\|artist=}}`	"{artist} Chart History (Japan Hot 100)". Billboard.
	`Oricon` → date<2021-03-15	84	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	84	Japan	Oricon	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`	120	Kazakhstan Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	`{{Single chart\|Kazakhstan\|0\|date=}}`	"Top Radio Hits Kazakhstan Weekly Chart". TopHit.
Latvia	`Latvia`	23	Latvia Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	`{{Single chart\|Latvia\|0\|date=}}`	"Top Radio Hits Latvia Weekly Chart". TopHit.
Lithuania	`Lithuania`	60	Lithuania Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	`{{Single chart\|Lithuania\|0\|date=}}`	"Top Radio Hits Lithuania Weekly Chart". TopHit.
Luxembourg	`Luxembourgdigitalsongs` (defunct)	76	Luxembourg Digital Song Sales	Billboard	artist	`{{Single chart\|Luxembourgdigitalsongs\|0\|artist=}}`	"{artist} Chart History (Luxembourg Digital Song Sales)". Billboard. {{dead link\|date=November 2021}}
Mexico	`Mexico Anglo`	61	Mexico Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Mexico Anglo\|0\|date=}}`	"Top 20 México Anglo música". Monitor Latino.
Mexico	`Mexico ML`	18	Mexico Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Mexico ML\|0\|date=}}`	"Top 20 México música". Monitor Latino.
Moldova	`Moldova`	97	Moldova Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	`{{Single chart\|Moldova\|0\|date=}}`	"Top Radio Hits Moldova Weekly Chart". TopHit.
Netherlands	`Dutch100`	9935	Netherlands	Single Top 100	artist, song	`{{Single chart\|Dutch100\|0\|artist=\|song=}}`	"{artist} – {song}" (in Dutch). Single Top 100.
	`Dutch40` → year, week	6271	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	6271	Netherlands	Dutch Top 40	artist	`{{Single chart\|Dutch40\|0\|artist=}}`	"Nederlandse Top 40 – {artist}" (in Dutch). Dutch Top 40.	Links to search results page.
New Zealand	`New Zealand`	7117	New Zealand	Recorded Music NZ	artist, song	`{{Single chart\|New Zealand\|0\|artist=\|song=}}`	"{artist} – {song}". Top 40 Singles.
Nicaragua	`Nicaragua`	11	Nicaragua Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Nicaragua\|0\|date=}}`	"Top 20 Nicaragua música". Monitor Latino.	Data from November 27, 2017.
Nicaragua	`Nicaragua Anglo`	67	Nicaragua Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Nicaragua Anglo\|0\|date=}}`	"Top 20 Nicaragua Anglo música". Monitor Latino.	Data from November 27, 2017.
Norway	`Norway` → year, week	3622	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	`Norway` → artist, song	3622	Norway	VG-lista	artist, song	`{{Single chart\|Norway\|0\|artist=\|song=}}`	"{artist} – {song}". VG-lista.
Panama	`Panama`	19	Panama Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Panama\|0\|date=}}`	"Top 20 Panamá música". Monitor Latino.	Data from December 5, 2016.
Panama	`Panama Anglo`	49	Panama Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Panama Anglo\|0\|date=}}`	"Top 20 Panamá Anglo música". Monitor Latino.	Data from December 5, 2016.
Paraguay	`Paraguay`	35	Paraguay Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Paraguay\|0\|date=}}`	"Top 20 Paraguay música". Monitor Latino.	Data from February 27, 2017.
Paraguay	`Paraguay Anglo`	40	Paraguay Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Paraguay Anglo\|0\|date=}}`	"Top 20 Paraguay Anglo música". Monitor Latino.	Data from February 27, 2017.
Peru	`Peru`	20	Peru Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Peru\|0\|date=}}`	"Top 20 Perú música". Monitor Latino.
Peru	`Peru Anglo`	51	Peru Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Peru Anglo\|0\|date=}}`	"Top 20 Perú Anglo música". Monitor Latino.
Philippines	`Philippines`	74	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	`Philippines Top Songs`	5	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.	Data from July 6, 2024.
Poland	`Poland`	1118	Poland	Polish Airplay Top 100	year, chartid	`{{Single chart\|Poland\|0\|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]	`{{Single chart\|Poland2\|0\|date=}}`	"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	`{{Single chart\|Polishdance\|0\|chartid=}}`	"Listy bestsellerów, wyróżnienia :: Związek Producentów Audio-Video". Polish Dance Top 50.
Portugal	`Portugal`	2070	Portugal	AFP	artist, song	`{{Single chart\|Portugal\|0\|artist=\|song=}}`	"{artist} – {song}". AFP Top 100 Singles.
	`Portugalairplay`	47	Portugal Airplay	AFP	chartid	`{{Single chart\|Portugalairplay\|0\|chartid=}}`	"TOP 100 - Lista". Audiogest.
	`Portugaldigitalsongs` (defunct)	65	Portugal Digital Song Sales	Billboard	artist	`{{Single chart\|Portugaldigitalsongs\|0\|artist=}}`	"{artist} Chart History (Portugal Digital Song Sales)". Billboard. {{dead link\|date=November 2021}}
Puerto Rico	`Puerto Rico`	14	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	`Puerto Rico Anglo`	36	Puerto Rico Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Puerto Rico Anglo\|0\|date=}}`	"Top 20 Puerto Rico Anglo música". Monitor Latino.	Data from August 13, 2018.
Romania	`Romaniaradioairplay`	231	Romania	Romanian Radio Airplay	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.
Romania	`Romaniatvairplay`	149	Romania	Romania TV Airplay	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`	612	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	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 2016w35. Week format: leading zero required.
	`Slovakdigital2`	1350	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	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 2016w35. Week format: leading zero required.
	`Slovakia2`	926	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)	149	South Africa	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	261	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`	261	South Africa Streaming	TOSAC	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`	2272	Spain	Promusicae	artist, song	`{{Single chart\|Spain\|0\|artist=\|song=}}`	"{artist} – {song}". Canciones Top 50.
Sweden	`Sweden`	6314	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	`Switzerland`	8316	Switzerland	Schweizer Hitparade	artist, song	`{{Single chart\|Switzerland\|0\|artist=\|song=}}`	"{artist} – {song}". Swiss Singles Chart.
Ukraine	`Ukraineradio`	501	Ukraine Airplay	TopHit	date [YYYYMMDD-YYYYMMDD]	`{{Single chart\|Ukraineradio\|0\|date=}}`	"Top Radio Hits Ukraine Weekly Chart". TopHit.
United Kingdom	`Ireland4`	1188	Ireland	IRMA	date [YYYYMMDD]	`{{Single chart\|Ireland4\|0\|date=}}`	"Official Irish Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
	`Scotland`	7880	Scotland Singles	OCC	date [YYYYMMDD]	`{{Single chart\|Scotland\|0\|date=}}`	"Official Scottish Singles Sales Chart on 15/1/2024 – Top 100". Official Charts Company.
	`UK`	12593	UK Singles	OCC	date [YYYYMMDD]	`{{Single chart\|UK\|0\|date=}}`	"Official Singles Chart on 15/1/2024 – Top 100". Official Charts Company.
	`UKZobbel`	64	UK Singles	OCC	date [YYMMDD]	`{{Single chart\|UKZobbel\|0\|date=}}`	"Chart Log UK: 15.01.2011". UK singles chart. Zobbel.de.
	`UKafrobeats`	85	UK Afrobeats	OCC	date [YYYYMMDD]	`{{Single chart\|UKafrobeats\|0\|date=}}`	"Official Afrobeats Chart on 15/1/2024 – Top 20". Official Charts Company.
	`UKdance`	1693	UK Dance	OCC	date [YYYYMMDD]	`{{Single chart\|UKdance\|0\|date=}}`	"Official Dance Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
	`UKdownload`	756	UK Singles Downloads	OCC	date [YYYYMMDD]	`{{Single chart\|UKdownload\|0\|date=}}`	"Official Singles Downloads Chart on 15/1/2024 – Top 100". Official Charts Company.
	`UKindependent`	125	→ UKindie
	`UKindie`	1249	UK Indie	OCC	date [YYYYMMDD]	`{{Single chart\|UKindie\|0\|date=}}`	"Official Independent Singles Chart on 15/1/2024 – Top 50". Official Charts Company.
	`UKphysical`	5	UK Physical Singles	OCC	date [YYYYMMDD]	`{{Single chart\|UKphysical\|0\|date=}}`	"Official Physical Singles Chart on 15/1/2024". Official Charts Company.
	`UKrandb`	2564	UK Hip Hop/R&B	OCC	date [YYYYMMDD]	`{{Single chart\|UKrandb\|0\|date=}}`	"Official Hip Hop and R&B Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
	`UKrock`	705	UK Rock & Metal	OCC	date [YYYYMMDD]	`{{Single chart\|UKrock\|0\|date=}}`	"Official Rock & Metal Singles Chart on 15/1/2024 – Top 40". Official Charts Company.
	`UKsinglesbyname` → artistid	3955	UK Singles	OCC	artistid, artist	`{{Single chart\|UKsinglesbyname\|0\|artistid=\|artist=}}`	"{artist} Songs and Albums \| Full Official Chart History". Official Charts Company.
	`UKsinglesbyname` → artist	3955	UK Singles	OCC	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`	177	UK Audio Streaming	OCC	date [YYYYMMDD]	`{{Single chart\|UKstreaming\|0\|date=}}`	"Official Audio Streaming Chart on 15/1/2024 – Top 100". Official Charts Company.
United States	`Billboardadultalternativesongs`	741	US Adult Alternative Airplay	Billboard	artist	`{{Single chart\|Billboardadultalternativesongs\|0\|artist=}}`	"{artist} Chart History (Adult Alternative Airplay)". Billboard.
	`Billboardadultcontemporary`	3068	US Adult Contemporary	Billboard	artist	`{{Single chart\|Billboardadultcontemporary\|0\|artist=}}`	"{artist} Chart History (Adult Contemporary)". Billboard.
	`Billboardadultpopsongs`	2691	US Adult Pop Airplay	Billboard	artist	`{{Single chart\|Billboardadultpopsongs\|0\|artist=}}`	"{artist} Chart History (Adult Pop Songs)". Billboard.
	`Billboardadultrandbsongs`	293	US Adult R&B Songs	Billboard	artist	`{{Single chart\|Billboardadultrandbsongs\|0\|artist=}}`	"{artist} Chart History (Adult R&B Songs)". Billboard.
	`Billboardafrobeats`	46	US Afrobeats Songs	Billboard	artist	`{{Single chart\|Billboardafrobeats\|0\|artist=}}`	"{artist} Chart History (Afrobeats Songs)". Billboard.
	`Billboardalternativesongs`	1901	US Alternative Airplay	Billboard	artist	`{{Single chart\|Billboardalternativesongs\|0\|artist=}}`	"{artist} Chart History (Alternative Airplay)". Billboard.
	`Billboardbubbling100`	2315	US Bubbling Under Hot 100	Billboard	artist	`{{Single chart\|Billboardbubbling100\|0\|artist=}}`	"{artist} Chart History (Bubbling Under Hot 100)". Billboard.
	`Billboardchristianairplay`	234	US Christian Airplay	Billboard	artist	`{{Single chart\|Billboardchristianairplay\|0\|artist=}}`	"{artist} Chart History (Christian Airplay)". Billboard.
	`Billboardchristiansongs`	407	US Hot Christian Songs	Billboard	artist	`{{Single chart\|Billboardchristiansongs\|0\|artist=}}`	"{artist} Chart History (Hot Christian Songs)". Billboard.
	`Billboardcountryairplay`	1146	US Country Airplay	Billboard	artist	`{{Single chart\|Billboardcountryairplay\|0\|artist=}}`	"{artist} Chart History (Country Airplay)". Billboard.
	`Billboardcountrysongs`	6188	US Hot Country Songs	Billboard	artist	`{{Single chart\|Billboardcountrysongs\|0\|artist=}}`	"{artist} Chart History (Hot Country Songs)". Billboard.
	`Billboarddanceairplay`	942	US Dance/Mix Show Airplay	Billboard	artist	`{{Single chart\|Billboarddanceairplay\|0\|artist=}}`	"{artist} Chart History (Dance Mix/Show Airplay)". Billboard.
	`Billboarddanceclubplay`	2564	US Dance Club Songs	Billboard	artist	`{{Single chart\|Billboarddanceclubplay\|0\|artist=}}`	"{artist} Chart History (Dance Club Songs)". Billboard.
	`Billboarddanceelectronic`	1094	US Hot Dance/Electronic Songs	Billboard	artist	`{{Single chart\|Billboarddanceelectronic\|0\|artist=}}`	"{artist} Chart History (Hot Dance/Electronic Songs)". Billboard.
	`Billboarddancepop`	52	US Hot Dance/Pop Songs	Billboard	artist	`{{Single chart\|Billboarddancepop\|0\|artist=}}`	"{artist} Chart History (Hot Dance/Pop Songs)". Billboard.
	`Billboarddancesales`	902	US Dance Singles Sales	Billboard	artist	`{{Single chart\|Billboarddancesales\|0\|artist=}}`	"{artist} Chart History (Dance Singles Sales)". Billboard.
	`Billboarddigitalsongs`	415	US Digital Song Sales	Billboard	artist	`{{Single chart\|Billboarddigitalsongs\|0\|artist=}}`	"{artist} Chart History (Digital Song Sales)". Billboard.
	`Billboardhardrock`	14	US Hot Hard Rock Songs	Billboard	artist	`{{Single chart\|Billboardhardrock\|0\|artist=}}`	"{artist} Chart History (Hot Hard Rock Songs)". Billboard.
	`Billboardhot100`	13133	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`	534	US Latin Airplay	Billboard	artist	`{{Single chart\|Billboardlatinairplay\|0\|artist=}}`	"{artist} Chart History (Latin Airplay)". Billboard.
	`Billboardlatinpopsongs`	638	US Latin Pop Airplay	Billboard	artist	`{{Single chart\|Billboardlatinpopsongs\|0\|artist=}}`	"{artist} Chart History (Latin Pop Airplay)". Billboard.
	`Billboardlatinpopsongs2`	4	US Hot Latin Pop Songs	Billboard	artist	`{{Single chart\|Billboardlatinpopsongs2\|0\|artist=}}`	"{artist} Chart History (Hot Latin Pop Songs)". Billboard.
	`Billboardlatinrhythm`	291	US Latin Rhythm Airplay	Billboard	artist	`{{Single chart\|Billboardlatinrhythm\|0\|artist=}}`	"{artist} Chart History (Latin Rhythm Airplay)". Billboard.
	`Billboardlatinrhythmsongs2`	15	US Hot Latin Rhythm Songs	Billboard	artist	`{{Single chart\|Billboardlatinrhythmsongs2\|0\|artist=}}`	"{artist} Chart History (Hot Latin Rhythm Songs)". Billboard.
	`Billboardlatinsongs`	1288	US Hot Latin Songs	Billboard	artist	`{{Single chart\|Billboardlatinsongs\|0\|artist=}}`	"{artist} Chart History (Hot Latin Songs)". Billboard.
	`Billboardmainstreamrock`	1988	US Mainstream Rock	Billboard	artist	`{{Single chart\|Billboardmainstreamrock\|0\|artist=}}`	"{artist} Chart History (Mainstream Rock)". Billboard.
	`Billboardpopsongs`	3765	US Pop Airplay	Billboard	artist	`{{Single chart\|Billboardpopsongs\|0\|artist=}}`	"{artist} Chart History (Pop Songs)". Billboard.
	`Billboardradiosongs`	280	US Radio Songs	Billboard	artist	`{{Single chart\|Billboardradiosongs\|0\|artist=}}`	"{artist} Chart History (Radio Songs)". Billboard.
	`Billboardrandbhiphop`	5905	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`	499	US R&B/Hip-Hop Airplay	Billboard	artist	`{{Single chart\|Billboardrandbhiphopairplay\|0\|artist=}}`	"{artist} Chart History (R&B/Hip-Hop Airplay)". Billboard.
	`Billboardrandbsongs`	8	US Hot R&B Songs	Billboard	artist	`{{Single chart\|Billboardrandbsongs\|0\|artist=}}`	"{artist} Chart History (Hot R&B Songs)". Billboard.
	`Billboardrapsongs`	1270	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`	3332	US Rhythmic Airplay	Billboard	artist	`{{Single chart\|Billboardrhythmic\|0\|artist=}}`	"{artist} Chart History (Rhythmic Airplay)". Billboard.
	`Billboardrockairplay`	925	US Rock & Alternative Airplay	Billboard	artist	`{{Single chart\|Billboardrockairplay\|0\|artist=}}`	"{artist} Chart History (Rock & Alternative Airplay)". Billboard.
	`Billboardrocksongs`	1851	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. {{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`	405	US Tropical Airplay	Billboard	artist	`{{Single chart\|Billboardtropicalairplay\|0\|artist=}}`	"{artist} Chart History (Tropical Airplay)". Billboard.
	`Billboardtropicalsongs2`	7	US Hot Tropical Songs	Billboard	artist	`{{Single chart\|Billboardtropicalsongs2\|0\|artist=}}`	"{artist} Chart History (Hot Tropical Songs)". Billboard.
Uruguay	`Uruguay`	20	Uruguay Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Uruguay\|0\|date=}}`	"Top 20 Uruguay música". Monitor Latino.
Uruguay	`Uruguay Anglo`	41	Uruguay Anglo Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Uruguay Anglo\|0\|date=}}`	"Top 20 Uruguay Anglo música". Monitor Latino.
Venezuela	`Venezuela`	4	Venezuela Airplay	Monitor Latino	date [YYYYMMDD]	`{{Single chart\|Venezuela\|0\|date=}}`	"Top 20 Venezuela música". Monitor Latino.
Venezuela	`Venezuela Anglo`	43	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 date format, invalid year format, invalid week format, manual mode missing url/title, URL validation failed.

Preview warnings

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

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

Australia (ARIA)^[1] WARNING: Unused parameters for "Australia": week.	5

^ "Example – Example". ARIA Top 50 Singles.

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

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

Maintenance categories

Usage tracking

Category:Single chart usages (192) – contains subcategories for each chart ID
Category:Single chart making named ref (9,989) – template created a named reference
Category:Single chart used with defunct chart (4,529) – chart marked as no longer active
Category:Single chart called without artist (20,093) – artist parameter not provided
Category:Single chart called without song (33,690) – song parameter not provided
Category:Single chart using manual ref mode (13) – 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 (63) – 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,144) – 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	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