Template:Album chart

Template documentationviewedithistorypurge

This template cites sources for albums. Related: {{Single chart}}, {{Year-end album 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)

{{Album chart |(Chart identifier) |(Peak position) |artist= |album= |dvd= |id= |url= |date= |year= |week= |note= |publish-date= |access-date= |refname= |refgroup= |rowheader= }} It is a good practice to always include album 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

{{Album chart|Billboard200|1|artist=Taylor Swift|album=1989|access-date=January 1, 2025|rowheader=true}}

Produces:

Australian Albums (ARIA)	1

Reference naming

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

...some fact.<ref name="ac_Billboard200_Taylor Swift"/>

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 album 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.
album	Album 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 album 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: ac_{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
dvd	DVD title. For Music DVD charts, use instead of album.
startdate, enddate	(deprecated) Date range for chart week. Used only in reference link text for FlandersMV, WalloniaMV, and ItalyMV.

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 Album''
! scope="col"| Chart (2024)
! scope="col"| Peak<br>position
|-
{{Album chart|Australia|6|album=Example Album|artist=Example Artist|rowheader=true}}
|-
! scope="row"| [[Oricon|Japan Oricon Albums]]<ref>"Oricon Weekly Album Chart". ''Oricon''. January 2024.</ref>
| style="text-align:center;"| 1
|-
{{Album chart|Austria|3|artist=Example Artist|album=Example Album|note=deluxe edition|rowheader=true}}
|-
{{Album chart|UK|3|artist=Example Artist|date=20240115|rowheader=true}}
|}

Expands into:

Chart performance for Example Album

Chart (2024)	Peak position
Australian Albums (ARIA)	6
Japan Oricon Albums	1
Austrian Albums (Ö3 Austria) deluxe edition	3
UK Albums (Official Charts)	3

Manual reference mode

Use when:

• Album 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)
{{Album 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/album.json • Testcases: Template:Album chart/testcases

Album chart outputs

Group	Chart ID	Uses	Chart	Provider	Required params	Template call	Sample ref output	Notes
Argentina	Argentina (defunct)	40	Argentine Albums	CAPIF	artist, album, date [DD/MM/YYYY]	{{Album chart|Argentina|0|artist=|album=|date=}}	"{artist} – {album}". Argentine Albums. CAPIF. Note: On Fecha, select 2024-01-15 to see the correspondent chart. {{dead link|date=April 2013}}	Data from February 7, 2010.
Australia	Australia	6622	Australian Albums	ARIA	artist, album	{{Album chart|Australia|0|artist=|album=}}	"Australiancharts.com – {artist} – {album}". Hung Medien.
Austria	Austria	7336	Austrian Albums	Ö3 Austria	artist, album	{{Album chart|Austria|0|artist=|album=}}	"Austriancharts.at – {artist} – {album}" (in German). Hung Medien.
Belgium	Flanders	8186	Belgian Albums	Ultratop Flanders	artist, album	{{Album chart|Flanders|0|artist=|album=}}	"Ultratop.be – {artist} – {album}" (in Dutch). Hung Medien.
	Wallonia	6934	Belgian Albums	Ultratop Wallonia	artist, album	{{Album chart|Wallonia|0|artist=|album=}}	"Ultratop.be – {artist} – {album}" (in French). Hung Medien.
Brazil	Brazil	19	Brazilian Albums	ABPD	id	{{Album chart|Brazil|0|id=}}	"ABPD CD - TOP 10 Semanal" (in Portuguese). Associação Brasileira dos Produtores de Discos.	The 'id' is the number at the end of the URL (noticia=).
Canada	BillboardCanada	4471	Canadian Albums	Billboard	artist	{{Album chart|BillboardCanada|0|artist=}}	"{artist} Chart History (Canadian Albums)". Billboard.
	Canada	2718	Canada Top Albums/CDs	RPM	chartid	{{Album chart|Canada|0|chartid=}}	"Top RPM Albums: Image 12345". RPM. Library and Archives Canada.	The 'chartid' is the number after nlc008388. in the URL.
Croatia	Croatia	106	Croatian International Albums	HDU	id	{{Album chart|Croatia|0|id=}}	"Top Stranih [Top Foreign]" (in Croatian). Top Foreign Albums. Hrvatska diskografska udruga.	The 'id' is the number at the end of the URL.
	CroatiaCombined	24	Croatian Albums	HDU	id	{{Album chart|CroatiaCombined|0|id=}}	"Top Kombiniranih [Top Combined]" (in Croatian). Top Combined Albums. Hrvatska diskografska udruga.
Czech Republic	Czech	1010	Czech Albums	ČNS IFPI	week, year	{{Album chart|Czech|0|week=|year=}}	"ČNS IFPI – CZ Albums – Top 100 – 3. týden 2024" (in Czech). ČNS IFPI.	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.
Denmark	Denmark	2385	Danish Albums	Hitlisten	artist, album	{{Album chart|Denmark|0|artist=|album=}}	"Danishcharts.dk – {artist} – {album}". Hung Medien.	Not recommended for charts prior to November 2007. Use Denmark2 instead.
	Denmark2	24	Danish Albums	Hitlisten	week, year	{{Album chart|Denmark2|0|week=|year=}}	"Top 40 Albums - 3 / 2024". Tracklisten.	For album charts prior to November 2007.
Finland	Finland	3502	Finnish Albums	Suomen virallinen lista	artist, album	{{Album chart|Finland|0|artist=|album=}}	"{artist}: {album}" (in Finnish). Musiikkituottajat – IFPI Finland.
France	France	6164	French Albums	SNEP	artist, album	{{Album chart|France|0|artist=|album=}}	"Lescharts.com – {artist} – {album}". Hung Medien.
Germany	Germany	10921	German Albums	Offizielle Top 100	id, artist, album	{{Album chart|Germany|0|id=|artist=|album=}}	"Offiziellecharts.de – {artist} – {album}" (in German). GfK Entertainment charts.	The 'id' is the number at the end of the URL.
	GermanyComp	31	German Compilation Albums	Offizielle Top 100	date [DD.MM.YYYY]	{{Album chart|GermanyComp|0|date=}}	"Offizielle Deutsche Charts – Top 30 Compilation-Charts". GfK Entertainment charts.	Data available from 1992. Use the first date above the chart as date (right after 'Datum:'). Module converts it into the ID.
	GermanyPop	4	German Pop Albums	Offizielle Top 100	id, artist, album	{{Album chart|GermanyPop|0|id=|artist=|album=}}	"Offiziellecharts.de – {artist} – {album}" (in German). GfK Entertainment charts.	The 'id' is the number at the end of the URL.
Greece	Greece (defunct)	222	Greek Albums	IFPI	artist, album	{{Album chart|Greece|0|artist=|album=}}	"Greekcharts.com – {artist} – {album}". Hung Medien. Archived from the original. {{dead link|date=November 2013}}	Data available from 2010 to 2011, week 31 only.
Hungary	Hungary	2435	Hungarian Albums	MAHASZ	year, week	{{Album chart|Hungary|0|year=|week=}}	"Album Top 40 slágerlista – 2024. 3. hét" (in Hungarian). MAHASZ.
	HungaryComp	1	Hungarian Compilation Albums	MAHASZ	year, week	{{Album chart|HungaryComp|0|year=|week=}}	"Válogatás- és mixlemezek slágerlistája – 2024. 3. hét" (in Hungarian). MAHASZ.	Data available from 2000. Listed under the main albums chart.
Ireland	Ireland (defunct)	1378	Irish Albums	IRMA	year, week	{{Album chart|Ireland|0|year=|week=}}	"GFK Chart-Track Albums: Week 3, 2024". GfK Chart-Track. IRMA. Archived from the original.	Week 1–53, no leading zero. Data 2000–2016.
	Ireland2	2060	Irish Albums	IRMA	artist	{{Album chart|Ireland2|0|artist=}}	"Irish-charts.com – Discography {artist}". Hung Medien.	Links to the artist's discography.
	Ireland3	828	Irish Albums	Official Charts	date [YYYYMMDD]	{{Album chart|Ireland3|0|date=}}	"Official Irish Albums Chart on 15/1/2024 – Top 50". Official Charts Company.	Data from January 6, 2017.
	IrelandClassical (defunct)	3	Irish Classical Albums	IRMA	year, week	{{Album chart|IrelandClassical|0|year=|week=}}	"GFK Chart-Track – Classical Albums: Week 3, 2024". GfK Chart-Track. IRMA. Archived from the original.	Week 1–53, no leading zero.
	IrelandComp (defunct)	12	Irish Compilation Albums	IRMA	year, week	{{Album chart|IrelandComp|0|year=|week=}}	"GFK Chart-Track – Multi-Artist Compilation Albums: Week 3, 2024". GfK Chart-Track. IRMA. Archived from the original.
	IrelandIndependent (defunct)	38	Irish Independent Albums	IRMA	year, week	{{Album chart|IrelandIndependent|0|year=|week=}}	"GFK Chart-Track – Independent Albums: Week 3, 2024". GfK Chart-Track. IRMA. Archived from the original.
Italy	Italy	3247	Italian Albums	FIMI	artist, album	{{Album chart|Italy|0|artist=|album=}}	"Italiancharts.com – {artist} – {album}". Hung Medien.
Japan	Oricon → date<2021-03-15	1634	Japanese Albums	Oricon	date [YYYY-MM-DD]	{{Album chart|Oricon|0|date=}}	"Oricon Top 50 Albums: 2024-01-15" (in Japanese). Oricon. Archived from the original.	Charts before March 15, 2021 are available only in the archive.
	Oricon → date>=2021-03-15				date [YYYY-MM-DD]	{{Album chart|Oricon|0|date=}}	"Oricon Top 50 Albums: 2024-01-15" (in Japanese). Oricon.
Mexico	Mexico	191	Mexican Albums	Top 100 Mexico	artist, album	{{Album chart|Mexico|0|artist=|album=}}	"Mexicancharts.com – {artist} – {album}". Hung Medien.	Data available until 2011, week 49. Use Mexico2 for later data.
	Mexico2 (defunct)	18	Mexican Albums	Top 100 Mexico	archiveurl, artist, album, archivedate	{{Album chart|Mexico2|0|archiveurl=|artist=|album=|archivedate=}}	"[{archiveurl} {artist} – {album}]". Asociación Mexicana de Productores de Fonogramas y Videogramas. Archived from the original on {archivedate}.	Data from 2011, week 49 to 2013, week 18. Look for the archive links in the lists by year from Top 100 Mexico.
Netherlands	Netherlands	8842	Dutch Albums	Album Top 100	artist, album	{{Album chart|Netherlands|0|artist=|album=}}	"Dutchcharts.nl – {artist} – {album}" (in Dutch). Hung Medien.
	NetherlandsComp	19	Dutch Compilation Albums	Compilation Top 30	date, year, artist, album	{{Album chart|NetherlandsComp|0|date=|year=|artist=|album=}}	"Dutchcharts.nl – {artist} – {album}". Hung Medien.
New Zealand	New Zealand	6044	New Zealand Albums	RMNZ	artist, album	{{Album chart|New Zealand|0|artist=|album=}}	"Charts.nz – {artist} – {album}". Hung Medien.
Norway	Norway	5071	Norwegian Albums	VG-lista	artist, album	{{Album chart|Norway|0|artist=|album=}}	"Norwegiancharts.com – {artist} – {album}". Hung Medien.
Poland	Poland	1410	Polish Albums	ZPAV	id	{{Album chart|Poland|0|id=}}	"Oficjalna lista sprzedaży :: OLiS - Official Retail Sales Chart". OLiS. Polish Society of the Phonographic Industry.	The 'id' is the number at the end of the URL (idlisty=).
	Poland2	447	Polish Albums	ZPAV	date [DD.MM.YYYY-DD.MM.YYYY]	{{Album chart|Poland2|0|date=}}	"OLiS - oficjalna lista sprzedaży - albumy" (in Polish). OLiS. Polish Society of the Phonographic Industry. Note: Change the date to 19.12.2025–25.12.2025 under "zmień zakres od–do:".
Portugal	Portugal	2021	Portuguese Albums	AFP	artist, album	{{Album chart|Portugal|0|artist=|album=}}	"Portuguesecharts.com – {artist} – {album}". Hung Medien.
Slovakia	Slovakia	9	Slovak Albums	ČNS IFPI	week, year	{{Album chart|Slovakia|0|week=|year=}}	"ČNS IFPI – SK Albums – Top 100 – 3. týden 2024" (in Czech). ČNS IFPI.	Data from 2016w43. 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.
South Korea	Korea	138	South Korean Albums	Circle	date [YYYY.MM.DD-YYYY.MM.DD]	{{Album chart|Korea|0|date=}}	"South Korea Circle Album Chart". Circle Chart. Note: On the page, select "2025.12.19–2025.12.25" to obtain the corresponding chart.	Overall albums (national and foreign combined).
	KoreaInt	105	South Korean International Albums	Circle	date [YYYY.MM.DD-YYYY.MM.DD]	{{Album chart|KoreaInt|0|date=}}	"South Korea Circle International Album Chart". Circle Chart. Note: On the page, select "2025.12.19–2025.12.25" to obtain the corresponding chart.	Only albums from foreign artists.
	KoreaNat	0	South Korean National Albums	Circle	date [YYYY.MM.DD-YYYY.MM.DD]	{{Album chart|KoreaNat|0|date=}}	"South Korea Circle National Album Chart". Circle Chart. Note: On the page, select "2025.12.19–2025.12.25" to obtain the corresponding chart.	Only albums from Korean artists.
Spain	Spain	2995	Spanish Albums	Promusicae	artist, album	{{Album chart|Spain|0|artist=|album=}}	"Spanishcharts.com – {artist} – {album}". Hung Medien.
Sweden	Sweden	6607	Swedish Albums	Sverigetopplistan	artist, album	{{Album chart|Sweden|0|artist=|album=}}	"Swedishcharts.com – {artist} – {album}". Hung Medien.
Switzerland	Switzerland	10079	Swiss Albums	Schweizer Hitparade	artist, album	{{Album chart|Switzerland|0|artist=|album=}}	"Swisscharts.com – {artist} – {album}". Hung Medien.
United Kingdom	Scotland	8397	Scottish Albums	Official Charts	date [YYYYMMDD]	{{Album chart|Scotland|0|date=}}	"Official Scottish Albums Chart on 15/1/2024 – Top 100". Official Charts Company.	Data from February 27, 1994.
	UK	1774	UK Albums	Official Charts	artist	{{Album chart|UK|0|artist=}}	"{artist} Songs and Albums | Full Official Chart History". Official Charts Company.	The site uses an internal resolver to redirect artist names to their discography pages. If this does not work, use UK2.
	UK2	10735	UK Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UK2|0|date=}}	"Official Albums Chart on 15/1/2024 – Top 100". Official Charts Company.	Data from July 22, 1956.
	UKAmericana	275	UK Americana Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKAmericana|0|date=}}	"Official Americana Albums Chart on 15/1/2024 – Top 40". Official Charts Company.	Data from January 29, 2016.
	UKChristian	37	UK Christian & Gospel Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKChristian|0|date=}}	"Official Christian & Gospel Albums Chart on 15/1/2024 – Top 20". Official Charts Company.
	UKComp	162	UK Compilation Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKComp|0|date=}}	"Official Compilations Chart on 15/1/2024 – Top 100". Official Charts Company.	Data from February 6, 1994.
	UKCountry	356	UK Country Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKCountry|0|date=}}	"Official Country Artists Albums Chart on 15/1/2024 – Top 20". Official Charts Company.	Data from January 30, 1994.
	UKDance	460	UK Dance Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKDance|0|date=}}	"Official Dance Albums Chart on 15/1/2024 – Top 40". Official Charts Company.	Data from September 25, 2005.
	UKDigital	1488	UK Album Downloads	Official Charts	date [YYYYMMDD]	{{Album chart|UKDigital|0|date=}}	"Official Album Downloads Chart on 15/1/2024 – Top 100". Official Charts Company.	Data from April 9, 2006.
	UKIndependent	3146	UK Independent Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKIndependent|0|date=}}	"Official Independent Albums Chart on 15/1/2024 – Top 50". Official Charts Company.	Data from October 12, 1997.
	UKJazz	178	UK Jazz & Blues Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKJazz|0|date=}}	"Official Jazz & Blues Albums Chart on 15/1/2024 – Top 30". Official Charts Company.	Data from January 30, 1994.
	UKProgressive	84	UK Progressive Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKProgressive|0|date=}}	"Official Progressive Albums Chart on 15/1/2024 – Top 30". Official Charts Company.	Data from October 7, 2015.
	UKR&B	1386	UK R&B Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKR&B|0|date=}}	"Official R&B Albums Chart on 15/1/2024 – Top 40". Official Charts Company.	Data from October 9, 1994.
	UKRock	1883	UK Rock & Metal Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKRock|0|date=}}	"Official Rock & Metal Albums Chart on 15/1/2024 – Top 40". Official Charts Company.
	UKSoundtrack	202	UK Soundtrack Albums	Official Charts	date [YYYYMMDD]	{{Album chart|UKSoundtrack|0|date=}}	"Official Soundtrack Albums Chart on 15/1/2024 – Top 50". Official Charts Company.	Data from January 13, 2002.
	UKZobbel	116	UK Albums	Official Charts	date [YYMMDD]	{{Album chart|UKZobbel|0|date=}}	"Chart Log UK: 15.01.2011". UK Albums Chart. Zobbel.de.	Data available from January 15, 2005 to January 30, 2016.
United States	Billboard200	16851	US Billboard 200	—	artist	{{Album chart|Billboard200|0|artist=}}	"{artist} Chart History (Billboard 200)". Billboard.
	BillboardAlbumSales	781	US Top Album Sales	Billboard	artist	{{Album chart|BillboardAlbumSales|0|artist=}}	"{artist} Chart History (Top Album Sales)". Billboard.
	BillboardAlternative	1303	US Top Alternative Albums	Billboard	artist	{{Album chart|BillboardAlternative|0|artist=}}	"{artist} Chart History (Top Alternative Albums)". Billboard.
	BillboardBluegrass	46	US Top Bluegrass Albums	Billboard	artist	{{Album chart|BillboardBluegrass|0|artist=}}	"{artist} Chart History (Top Bluegrass Albums)". Billboard.
	BillboardBlues	108	US Top Blues Albums	Billboard	artist	{{Album chart|BillboardBlues|0|artist=}}	"{artist} Chart History (Top Blues Albums)". Billboard.
	BillboardCatalog	246	US Top Catalog Albums	Billboard	artist	{{Album chart|BillboardCatalog|0|artist=}}	"{artist} Chart History (Top Catalog Albums)". Billboard.
	BillboardChristian	904	US Top Christian Albums	Billboard	artist	{{Album chart|BillboardChristian|0|artist=}}	"{artist} Chart History (Christian Albums)". Billboard.
	BillboardClassical	123	US Top Classical Albums	Billboard	artist	{{Album chart|BillboardClassical|0|artist=}}	"{artist} Chart History (Top Classical Albums)". Billboard.
	BillboardClassicalCrossover	17	US Top Classical Crossover Albums	Billboard	artist	{{Album chart|BillboardClassicalCrossover|0|artist=}}	"{artist} Chart History (Top Classical Crossover Albums)". Billboard.
	BillboardComedy	43	US Top Comedy Albums	Billboard	artist	{{Album chart|BillboardComedy|0|artist=}}	"{artist} Chart History (Top Comedy Albums)". Billboard.
	BillboardContemporaryJazz	69	US Top Contemporary Jazz Albums	Billboard	artist	{{Album chart|BillboardContemporaryJazz|0|artist=}}	"{artist} Chart History (Top Contemporary Jazz Albums)". Billboard.
	BillboardCountry	2490	US Top Country Albums	Billboard	artist	{{Album chart|BillboardCountry|0|artist=}}	"{artist} Chart History (Top Country Albums)". Billboard.
	BillboardCurrentAlbums (defunct)	133	US Top Current Album Sales	Billboard	artist	{{Album chart|BillboardCurrentAlbums|0|artist=}}	"{artist} Chart History (Top Current Album Sales)". Billboard. {{dead link|date=March 2026}}
	BillboardDanceElectronic	836	US Top Dance Albums	Billboard	artist	{{Album chart|BillboardDanceElectronic|0|artist=}}	"{artist} Chart History (Top Dance/Electronic Albums)". Billboard.
	BillboardDigital (defunct)	320	US Digital Albums	Billboard	artist	{{Album chart|BillboardDigital|0|artist=}}	"{artist} Chart History (Digital Albums)". Billboard. {{dead link|date=October 2023}}
	BillboardFolk	499	US Americana/Folk Albums	Billboard	artist	{{Album chart|BillboardFolk|0|artist=}}	"{artist} Chart History (Top Americana/Folk Albums)". Billboard.
	BillboardGospel	164	US Top Gospel Albums	Billboard	artist	{{Album chart|BillboardGospel|0|artist=}}	"{artist} Chart History (Top Gospel Albums)". Billboard.
	BillboardHardRock	870	US Top Hard Rock Albums	Billboard	artist	{{Album chart|BillboardHardRock|0|artist=}}	"{artist} Chart History (Top Hard Rock Albums)". Billboard.
	BillboardHeatseekers	2112	US Heatseekers Albums	Billboard	artist	{{Album chart|BillboardHeatseekers|0|artist=}}	"{artist} Chart History (Heatseekers Albums)". Billboard.
	BillboardHoliday	208	US Top Holiday Albums	Billboard	artist	{{Album chart|BillboardHoliday|0|artist=}}	"{artist} Chart History (Holiday Albums)". Billboard.
	BillboardIndependent	3449	US Independent Albums	Billboard	artist	{{Album chart|BillboardIndependent|0|artist=}}	"{artist} Chart History (Independent Albums)". Billboard.
	BillboardJazz	292	US Top Jazz Albums	Billboard	artist	{{Album chart|BillboardJazz|0|artist=}}	"{artist} Chart History (Top Jazz Albums)". Billboard.
	BillboardLatin	687	US Top Latin Albums	Billboard	artist	{{Album chart|BillboardLatin|0|artist=}}	"{artist} Chart History (Top Latin Albums)". Billboard.
	BillboardLatinPop	378	US Latin Pop Albums	Billboard	artist	{{Album chart|BillboardLatinPop|0|artist=}}	"{artist} Chart History (Latin Pop Albums)". Billboard.
	BillboardLatinRhythm	132	US Latin Rhythm Albums	Billboard	artist	{{Album chart|BillboardLatinRhythm|0|artist=}}	"{artist} Chart History (Latin Rhythm Albums)". Billboard.
	BillboardRandB	42	US Top R&B Albums	Billboard	artist	{{Album chart|BillboardRandB|0|artist=}}	"{artist} Chart History (Top R&B Albums)". Billboard.
	BillboardRandBHipHop	4885	US Top R&B/Hip-Hop Albums	Billboard	artist	{{Album chart|BillboardRandBHipHop|0|artist=}}	"{artist} Chart History (Top R&B/Hip-Hop Albums)". Billboard.
	BillboardRap	675	US Top Rap Albums	Billboard	artist	{{Album chart|BillboardRap|0|artist=}}	"{artist} Chart History (Top Rap Albums)". Billboard.
	BillboardReggae	84	US Reggae Albums	Billboard	artist	{{Album chart|BillboardReggae|0|artist=}}	"{artist} Chart History (Reggae Albums)". Billboard.
	BillboardRegionalMexican	104	US Regional Mexican Albums	Billboard	artist	{{Album chart|BillboardRegionalMexican|0|artist=}}	"{artist} Chart History (Regional Mexican Albums)". Billboard.
	BillboardRock	2774	US Top Rock Albums	Billboard	artist	{{Album chart|BillboardRock|0|artist=}}	"{artist} Chart History (Top Rock Albums)". Billboard.
	BillboardSoundtrack	283	US Soundtrack Albums	Billboard	artist	{{Album chart|BillboardSoundtrack|0|artist=}}	"{artist} Chart History (Soundtrack Albums)". Billboard.
	BillboardTastemaker	956	US Indie Store Album Sales	Billboard	artist	{{Album chart|BillboardTastemaker|0|artist=}}	"{artist} Chart History (Top Tastemaker Albums)". Billboard.
	BillboardTropical	99	US Tropical Albums	Billboard	artist	{{Album chart|BillboardTropical|0|artist=}}	"{artist} Chart History (Tropical Albums)". Billboard.
	BillboardVinyl	278	US Vinyl Albums	Billboard	artist	{{Album chart|BillboardVinyl|0|artist=}}	"{artist} Chart History (Vinyl Albums)". Billboard.
	BillboardWorld	353	US World Albums	Billboard	artist	{{Album chart|BillboardWorld|0|artist=}}	"{artist} Chart History (World Albums)". Billboard.

Music DVD chart outputs

Group	Chart ID	Uses	Chart	Provider	Required params	Template call	Sample ref output	Notes
Australia	AustraliaMV → archivedate<2011	31	Australian Music DVD	ARIA	archivedate, archiveurl	{{Album chart|AustraliaMV|0|archivedate=|archiveurl=}}	"[{archiveurl} Top 40 DVD Chart - Australian Record Industry Association]". Australian Recording Industry Association. Archived from the original on {archivedate}.	URL provides data from May 2008 to August 2012.
	AustraliaMV → archivedate<2016				archivedate, archiveurl	{{Album chart|AustraliaMV|0|archivedate=|archiveurl=}}	"[{archiveurl} ARIA Australian Top 40 Music DVDs]". Australian Recording Industry Association. Archived from the original on {archivedate}.	URL provides data from May 2011 to January 2016.
	AustraliaMV → archivedate>=2016				archivedate, archiveurl	{{Album chart|AustraliaMV|0|archivedate=|archiveurl=}}	"[{archiveurl} ARIA Australian Top 40 Music DVDs]". Australian Recording Industry Association. Archived from the original on {archivedate}.	URL provides data from February 2016 to December 2019.
Austria	AustriaMV	40	Austrian Music DVD	Ö3 Austria	date [DD-MM-YYYY]	{{Album chart|AustriaMV|0|date=}}	"Austria Top 40 – Musik-DVD: 15-01-2024" (in German). Ö3 Austria Top 40. Hung Medien.
Belgium	FlandersMV → date, year	33	Belgian Music DVD	Ultratop Flanders	date [YYYYMMDD], year	{{Album chart|FlandersMV|0|date=|year=}}	"Ultratop Muziek-Dvd: 2024 – 15.01.2024" (in Dutch). Ultratop.be. Hung Medien.	Use 'dvd' if album has [DVD] tag, otherwise 'album'. For archived charts: 'year' and 'date'.
	FlandersMV → artist, dvd				artist, dvd	{{Album chart|FlandersMV|0|artist=|dvd=}}	"{artist} – Sample DVD [DVD]" (in Dutch). Ultratop.be. Hung Medien.
	FlandersMV → artist, album				artist, album	{{Album chart|FlandersMV|0|artist=|album=}}	"{artist} – {album}" (in Dutch). Ultratop.be. Hung Medien.
	WalloniaMV → date, year	30	Belgian Music DVD	Ultratop Wallonia	date [YYYYMMDD], year	{{Album chart|WalloniaMV|0|date=|year=}}	"Ultratop Dvd Musicaux: 2024 – 15.01.2024" (in French). Ultratop.be. Hung Medien.
	WalloniaMV → artist, dvd				artist, dvd	{{Album chart|WalloniaMV|0|artist=|dvd=}}	"{artist} – Sample DVD [DVD]" (in French). Ultratop.be. Hung Medien.
	WalloniaMV → artist, album				artist, album	{{Album chart|WalloniaMV|0|artist=|album=}}	"{artist} – {album}" (in French). Ultratop.be. Hung Medien.
Denmark	DenmarkMV	12	Danish Music DVD	Hitlisten	week, year	{{Album chart|DenmarkMV|0|week=|year=}}	"Musik Video Top-10: Uge 3 – 2024" (in Danish). Hitlisten.NU.
Finland	FinlandMV	11	Finnish Music DVD	Suomen virallinen lista	artist, album	{{Album chart|FinlandMV|0|artist=|album=}}	"{artist}: {album}" (in Finnish). Musiikkituottajat – IFPI Finland.
France	FranceMV	30	French Music DVD	SNEP	id, artist, dvd	{{Album chart|FranceMV|0|id=|artist=|dvd=}}	"{artist} – Sample DVD" (in French). Classement Officiel des ventes de DVD Musicaux. SNEP.	The 'id' is the number in the URL before /videos-musicales.php.
Ireland	IrelandMV	0	Irish Music Videos	Official Charts	date [YYYYMMDD]	{{Album chart|IrelandMV|0|date=}}	"Official Irish Video Chart on 15/1/2024 – Top 50". Official Charts Company.	Data from January 6, 2017.
Italy	ItalyMV	41	Italian Music DVD	FIMI	year, week, startdate, enddate	{{Album chart|ItalyMV|0|year=|week=|startdate=|enddate=}}	"DVD: Classifica settimanale WK 3 (dal 01/01/2024 al 07/01/2024)" (in Italian). Federazione Industria Musicale Italiana.
Netherlands	NetherlandsMV → artist, dvd	50	Dutch Music DVD	MegaCharts	artist, dvd	{{Album chart|NetherlandsMV|0|artist=|dvd=}}	"{artist} – Sample DVD [DVD]" (in Dutch). Dutchcharts.nl. Hung Medien.	Use 'dvd' parameter if album name has [DVD] tag, otherwise use 'album'.
	NetherlandsMV → artist, album				artist, album	{{Album chart|NetherlandsMV|0|artist=|album=}}	"{artist} – {album}" (in Dutch). Dutchcharts.nl. Hung Medien.
Spain	SpainMV	29	Spanish Music DVD	Promusicae	year, week	{{Album chart|SpainMV|0|year=|week=}}	"Weekly Charts - Promusicae". Top 20 DVD Musical. Promusicae. Note: Select Category: DVD, Year: 2024, then find week 3 in the list.
Sweden	SwedenMV	39	Swedish Music DVD	Sverigetopplistan	year, week	{{Album chart|SwedenMV|0|year=|week=}}	"Veckolista DVD Album – Vecka 3, 2024" (in Swedish). Sverigetopplistan.	The URL contains 'year' (dspy=) and 'week' (dspp=) parameters.
Switzerland	SwitzerlandMV	32	Swiss Music DVD	Schweizer Hitparade	date [DD-MM-YYYY]	{{Album chart|SwitzerlandMV|0|date=}}	"Schweizer Hitparade – Musik-DVD Top 10: 15.01.2024". Swiss Hitparade. Hung Medien.
United Kingdom	UKMV	86	UK Music Videos	Official Charts	date [YYYYMMDD]	{{Album chart|UKMV|0|date=}}	"Official Music Video Chart on 15/1/2024 – Top 50". Official Charts Company.	Data from January 30, 1994.
United States	USMV (defunct)	29	US Music Video Sales	Billboard	artist	{{Album chart|USMV|0|artist=}}	"{artist} Chart History (Music Video Sales)". Billboard.	Data available from 1980.

Error handling

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

Error messages

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

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

19

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

Preview warnings

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

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

Australia (ARIA) WARNING: Unused parameters for "Australia": week.

5

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

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

Maintenance categories

Usage tracking

• Category:Album chart usages (116) – contains subcategories for each chart ID
• Category:Album chart making named ref (5,805) – template created a named reference
• Category:Album chart used with defunct chart (2,018) – chart marked as no longer active
• Category:Album chart called without artist (16,751) – artist parameter not provided
• Category:Album chart called without album (28,934) – album (or dvd) parameter not provided
• Category:Album chart using manual ref mode (3,005) – manual reference mode (M) used

Error tracking

• Category:Album chart used with unknown chart (0) – unrecognized chart ID
• Category:Album chart used with missing parameters (8) – required parameters not provided
• Category:Album chart with invalid position (11) – position is not a valid number (1–200) or dash
• Category:Pages using album chart with unknown parameters (1) – unrecognized parameters used
• Category:Album chart with unused parameters (0) – parameters provided but not used by chart
• Category:Album chart with unsubstituted parameters (9) – raw {{{param}}} or {placeholder} detected, likely an issue in code, JSON, or helper
• Category:Album 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:Album chart in articles based on its TemplateData.

TemplateData for Album 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

See also

• {{Single chart}}, {{Album chart}} — weekly charts
• {{Year-end single chart}}, {{Year-end album chart}} — year-end charts
• Module:Music chart — module documentation

The above documentation is transcluded from Template:Single chart/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Subpages of this template.