Template:Album chart/sandbox

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

This template is used to cite sources in Wikipedia. It is specifically for albums. A similar template for use when citing sources for musical singles can be found at Template:Single chart; however, for EPs or other releases, it has not yet been developed.

In general, the template expands to produce a table row with the information country, record chart, reference, and peak position for the given album on the particular chart. Tables of such information are commonly used in Wikipedia articles on singles, albums, discographies and artists.

This template does not verify any positions or chart appearances. It primarily provides a reference URL believed to be associated with a reliable source for a recognised chart. The reference URL itself is also not checked. Entering an incorrect or alternative spelling of an album title can produce a bad link, for example. Individual editors will need to follow the URLs generated by the template to verify their usefulness before walking away from an edited article.

Usage

Following, the most common parameters used on the template:

<syntaxhighlight lang="text" class="" style="" inline="1">{{Album chart|(Chart identifier)|(Peak position)|artist=|album=|refname=|access-date=30 May 2012|rowheader=true}}</syntaxhighlight>

Following, the parameters for any Billboard chart:

<syntaxhighlight lang="text" class="" style="" inline="1">{{Album chart|Billboard(Specific identifier)|(Peak position)|artist=|refname=|access-date=30 May 2012|rowheader=true}}</syntaxhighlight>

Following, the parameters for any UK chart (except for the main UK parameter and UKZobbel):

<syntaxhighlight lang="text" class="" style="" inline="1">{{Album chart|UK(Specific identifier)|(Peak position)|artist=|date=YYYY-MM-DD|refname=|access-date=30 May 2012|rowheader=true}}</syntaxhighlight>

Manual referencing

If the following situations arise:

1. The album name contains special characters that the <syntaxhighlight lang="text" class="" style="" inline="1">album=</syntaxhighlight> parameter doesn't handle correctly and returns an URL error.
2. When the template will be used for year-end charts instead of weekly charts.
3. When the chart position is retrieved from a source other than the default by {{Album chart}} such as Billboard's Chart Beat or Allmusic (remember that all sources must be reliable).

Then a manual reference might be needed. When manual referencing is activated, the user must provide the <syntaxhighlight lang="text" class="" style="" inline="1">url=</syntaxhighlight> and <syntaxhighlight lang="text" class="" style="" inline="1">title=</syntaxhighlight>, and may additionally provide <syntaxhighlight lang="text" class="" style="" inline="1">work=</syntaxhighlight>, <syntaxhighlight lang="text" class="" style="" inline="1">page=</syntaxhighlight>, <syntaxhighlight lang="text" class="" style="" inline="1">date=</syntaxhighlight>, <syntaxhighlight lang="text" class="" style="" inline="1">location=</syntaxhighlight> and (if specially relevant) <syntaxhighlight lang="text" class="" style="" inline="1">publisher=</syntaxhighlight>, just like on the {{cite news}} template, to add a different source than the commonly used by {{Album chart}}.

To activate manual referencing, write an "M" as the third parameter of the template, after the country name and chart position, as this:

• <syntaxhighlight lang="text" class="" style="" inline="1">{{Album chart|Australia|1|M|title=Madonna's "MDNA" Tops ARIA Charts|url=http://www.billboard.com/#/news/madonnas-mdna-tops-aria-charts-1584845.story|work=Billboard|location=United States|access-date=9 June 2012|rowheader=true}}</syntaxhighlight>

And it will show in a table as this:

Chart positions for MDNA

Chart	Peak
Australian Albums (ARIA)	1

This mode can be used simultaneously with the normal mode of the template, without the need to change the refname parameter.

• The manual referencing mode is not available for the Music DVD charts.

Fields

The parameters publish-date, access-date, and refname are optional. Whether the other parameters are required or not depend on the chart being referenced. See the tables in the Support section below.

• (Chart identifier) (or first parameter, without name): Chart identifier. Must be one of the options listed under Chart ID in the tables of the Support section below. Often named as a country or nationality (e.g., Spain or Spanish), but sometimes named for a specific chart (e.g., Billboardjapanhot100). Some charts allow more than one identifier; the results produced are identical.
• (Peak position) (or second parameter, without name): The number you found to be the peak position achieved by the single on the specific chart to date. If the song has not appeared on the chart (due to low popularity or lack of release in a country), you can enter a dash (–, not a hyphen -). Usually, it's better to omit the template completely.
• album: Title of the album. Made-up words, slang, "hip" spellings, tricky punctuation, etc., can make this parameter difficult to correctly determine. Make sure to check the resulting reference URL (Preview) before saving the definitive version of the article.
• dvd: For Music DVDs, the title of the album. Some Music DVD charts need to be provided with this field instead of the album field to correctly work.
• artist: Name of the album's performer. As for the album parameter, odd spellings and clever stylings (e.g., Ke$ha) can make this parameter difficult to correctly determine. The German chart, for example, typically requires names in lastname,firstname format. Make sure to check the resulting reference URL (Preview) before saving the definitive version of the article. Also note that this parameter is required for all charts where you are reusing the references using the default naming (see below). If you use the refname parameter, however, artist may not be absolutely necessary.
• id: Numeric identifier used by some chart listings (see Polish Music Charts). Determined by performing a search at the chart listings' website for archive chart. The chartid can be found in the Web address (URL) by inspection. For example, Polish Airplay Chart of 12 November 2011 at www.zpav.pl has the URL http://www.zpav.pl/rankingi/listy/nielsen/top5.php?lang=2&idlisty=532, so the chartid to use is 532.
• url: The URL of the reference where you found the song's peak position for the chart. Used only for particular charts (see Support tables) where there is no indexing system, not necessary (or even used) for others.
• urltitle: The title of the page for the reference where you found the song's peak position for the chart. Used in combination with the url parameter, and only for particular charts (see Support tables) where there is no indexing system, not necessary (or even used) for others.
• date: Date of the chart in the format YYYYMMDD, an 8-digit number indicating year (Y), month (M) and day (D). Used only for certain charts, as part of their URL strings (see Frenchdigital below); not necessary (or even used) for others. This date is used solely to create the reference URL to the download chart, and is not displayed textually in the references list. For general citation of any chart's publication date, use the optional publish-date parameter.
• year: Four-digit year indicating the year being reported by the chart. Used in combination with the week parameter and only for certain charts; not necessary (or even used) for others. Not necessarily the same as the publication date referred to by publish-date.
• week: Two-digit week indicating the week being reported by the chart. Week is a number from 01 to 53, with a leading 0 for weeks 01-09 (some charts do not require the leading zero; consult Support tables below). Used in combination with the year parameter and only for certain charts; not necessary (or even used) for others. Not necessarily related to the publication date referred to by publish-date.
• note: For adding a note about a particular version of an album, e.g., note=2-disc deluxe edition, or {{Album chart|Australia|1|album=Making Mirrors|artist=Gotye|note=2-disc deluxe edition}}.
• publish-date: Date of publication of the reference generated by the template, in the same format as other dates in citations in the same article. Optional parameter.
• access-date: Date that the reference generated by the template was retrieved to determine peak position (i.e., last date an editor verified this citation). Should be in the same format as other dates in citations in the same article. Optional parameter.
• refname: Enables you to specify a name for the reference generated by the template. If no value is provided for refname the default reference name (in the form ac_Chartid_artist) will be used. A reference with a name can be reused for claims elsewhere in the article. Optional parameter.
• refgroup: Enables you to specify a name for the reference group. Optional parameter.
• rowheader: An optional statement to identify the cell that contains this template with <syntaxhighlight lang="text" class="" style="" inline="1">scope=row</syntaxhighlight>. This should be present in almost all cases.

Supports

National charts

Supported international charts

Chart ID	Output	Website used as archive	Req.	Notes
Argentina	Argentinian Albums (CAPIF)	adminlic.capif.org.ar	artist album date	date must be in the format: DD/MM/YYYY. Charts available from 7 February 2010 onwards. When manual referencing is activated, write the date always as DD/MM/YYYY, otherwise, the template may return an error.
Australia	Australian Albums (ARIA)	www.australian-charts.com	artist album
Austria	Austrian Albums (Ö3 Austria)	www.austriancharts.at	artist album
Flanders	Belgian Albums (Ultratop Flanders)	www.ultratop.be	artist album
Wallonia	Belgian Albums (Ultratop Wallonia)	www.ultratop.be	artist album
Brazil	Brazilian Albums (PMB)	www.abpd.org.br	id	id is the number(s) at the end of the URL. For example, the id of http://www.abpd.org.br/noticias_internas.asp?noticia=168 is 168
Canada	Canada Top Albums/CDs (RPM)	www.bac-lac.gc.ca/	chartid	chartid is the number present after nlcxxxxx. For example in this example, the chartid is 2647.
CroatiaCombined	Croatian Albums (HDU)	www.hdu-toplista.com	id	id is the number(s) at the end of the URL. For example, the id of http://www.hdu-toplista.com/index.php?what=arhiva&w=details&id=1562 is 1562
Croatia	Croatian International Albums (HDU)	www.hdu-toplista.com	id	id is the number(s) at the end of the URL. For example, the id of http://www.hdu-toplista.com/index.php?what=arhiva&w=details&id=881 is 881
Czech	Czech Albums (ČNS IFPI)	www.ifpicr.cz	artist album week	week is the number at the end of the url. For example, for https://ifpicr.cz/hitparada/14?weekId=2750 use 2570
Denmark	Danish Albums (Hitlisten)	www.danishcharts.com	artist album	Not recommended for charts prior to Nov. 2007; use instead Denmark2.
Denmark2	Danish Albums (Hitlisten)	www.hitlisten.nu	week year	For album charts prior to Nov. 2007, is better to use this Chart ID.
Finland	Finnish Albums (Suomen virallinen lista)	www.ifpi.fi	artist album
France	French Albums (SNEP)	www.lescharts.com	artist album
Germany	German Albums (Offizielle Top 100)	www.musicline.de	artist album	Obsolete. As with Billboard charts, this URL returns the complete album (longplay) chart history for the selected artist.
Germany2	German Albums (Offizielle Top 100)	www.officialcharts.de	year date	Obsolete This website, instead of retrieving a complete chart history, it returns a weekly chart. The date parameter must be filled as this: YYYYMMDD. It contains chart info from 1978 onwards.
Germany3	German Albums (Offizielle Top 100)	www.officialcharts.de	artist album
Germany4	German Albums (Offizielle Top 100)	www.offiziellecharts.de	id artist album	id is the number(s) at the end of the URL. For example, the id of https://www.offiziellecharts.de/album-details-233637 is 233637
GermanyComp	German Compilation Albums (Offizielle Top 100)	www.charts.de	year date	This website, instead of retrieving a complete chart history, it returns a weekly chart. The date parameter must be filled as this: YYYYMMDD. It contains chart info from 1992 onwards.
Greece	Greek Albums (IFPI)	www.greekcharts.com	artist album	This website only contains chart information from 2010 to week 31/2011.
Hungary	Hungarian Albums (MAHASZ)	www.mahasz.hu	year week
HungaryComp	Hungarian Compilation Albums (MAHASZ)	www.mahasz.hu	year week	Since 2000, under the main albums chart.
Ireland	Irish Albums (IRMA)	www.chart-track.co.uk	year week	Obsolete Only from 2000 to 2016
Ireland2	Irish Albums (IRMA)	www.irish-charts.com	artist
Ireland3	Irish Albums (OCC)	www.officialcharts.com	artist date	Official Irish Albums Chart Top 50 archive from January 6, 2017 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
IrelandClassical	Irish Classical Albums (IRMA)	www.chart-track.co.uk	year week	Obsolete
IrelandComp	Irish Compilation Albums (IRMA)	www.chart-track.co.uk	year week	Obsolete
IrelandIndependent	Irish Independent Albums (IRMA)	www.chart-track.co.uk	year week	Obsolete
Italy	Italian Albums (FIMI)	www.italiancharts.com	artist album
Korea	South Korean Albums (Gaon)	www.gaonchart.co.kr	date	Overall albums (national and foreign). The date must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from the Gaon page.
KoreaNat	South Korean National Albums (Gaon)	www.gaonchart.co.kr	date	Only albums by Korean artists included here. The date must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from the Gaon page.
KoreaInt	South Korean International Albums (Gaon)	www.gaonchart.co.kr	date	Only albums from foreign artists included here. The date must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from the Gaon page.
Mexico	Mexican Albums (Top 100 Mexico)	www.mexicancharts.com	artist album	The site contains chart information until the week 49, 2011. After that date, no information is available. Information beyond that week must be added with the Mexico2 ChartID.
Mexico2	Mexican Albums (Top 100 Mexico)	www.amprofon.com.mx	artist album archiveurl archivedate	This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the URL [1] with either WebCite or any other archiving method. Then, providing the parameters needed on the template. This might only be done if the peak position is beyond the week 49, 2011 and uptill week18, 2013. Since May 2013, some positions of the chart are published in the official Twitter account of AMPROFON including the number one position. All parameters are mandatory. Archiving the PDF file or finding the arhived URL is highly recommended. On archiveurl the WebCite URL must be written.
Netherlands	Dutch Albums (MegaCharts)	www.dutchcharts.nl	artist album
NetherlandsComp	Dutch Compilation Albums (MegaCharts)	www.dutchcharts.nl	artist album year date	For this ID, the date and year parameters are mandatory. date must be in this format:YYYYMMDD.
New Zealand	New Zealand Albums (Recorded Music NZ)	www.charts.nz	artist album
Norway	Norwegian Albums (VG-lista)	www.norwegiancharts.com	artist album
Oricon	Japanese Albums (Oricon)	www.oricon.co.jp	date	This is the Oricon Top 50 Albums chart. It is in Japanese and the only parameter needed is the date. The date must follow this format: YYYY-MM-DD.
Poland	Polish Albums (ZPAV)	olis.onyx.pl	id	id is the number(s) at the end of the URL. For example, the id of http://olis.onyx.pl/listy/index.asp?idlisty=708 is 708
Poland2	Polish Albums (ZPAV)	www.olis.pl	date	date in the format dd.mm.yyyy used for specifying the date of the chart for manual searching.
Portugal	Portuguese Albums (AFP)	www.portuguesecharts.com	artist album
Switzerland	Swiss Albums (Schweizer Hitparade)	www.swisscharts.com	artist album
Sweden	Swedish Albums (Sverigetopplistan)	www.swedishcharts.com	artist album
Spain	Spanish Albums (PROMUSICAE)	www.spanishcharts.com	artist album

UK charts

British charts

Chart ID	Output	Requirements	Notes
UK	UK Albums (OCC)	artist	As with Billboard charts, this URL returns the complete album chart history for the selected artist.
UK2	UK Albums (OCC)	date	UK Top 100 Albums archive from 22 July 1956 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKAmericana	UK Americana Albums (OCC)	artist date	Americana albums archive from 29 January 2016 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKComp	UK Compilation Albums (OCC)	artist date	Compilation albums archive from 6 February 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKCountry	UK Country Albums (OCC)	artist date	Country albums archive from 30 January 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKDance	UK Dance Albums (OCC)	artist date	Dance albums archive from 25 September 2005 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKDigital	UK Digital Albums (OCC)	artist date	Digital albums archive from 9 April 2006 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKIndependent	UK Independent Albums (OCC)	artist date	Independent albums archive from 12 October 1997 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKJazz	UK Jazz & Blues Albums (OCC)	date	Jazz & blues albums archive from 30 January 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKProgressive	UK Progressive Albums (OCC)	artist date	Progressive albums archive from 7 October 2015 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKR&B	UK R&B Albums (OCC)	artist date	R&B albums archive from 9 October 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKRock	UK Rock & Metal Albums (OCC)	date	Rock & metal albums archive from 9 October 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKSoundtrack	UK Soundtrack Albums (OCC)	date	Soundtrack albums archive from 13 January 2002 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
Scotland	Scottish Albums (OCC)	artist date	Scottish albums archive from 27 February 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
UKZobbel	UK Albums (OCC)	id title	This uses Zobbel.de. id is the letter (A, B, C, etc.); title is what comes after "Chart Log UK:".

Billboard charts

Billboard charts all require the artist name. Special characters should be omitted from the artist's name to be passed correctly into the URL. For example,

• {{Album chart|Billboard200|1|artist=Pnk}} is the syntax for citing a number 1 position on the Billboard 200 for P!nk.

The reference generated by the template will point to the following URL: http://www.billboard.com/music/pnk/chart-history/billboard-200.

• Entering the artist name as "P!nk" will produce an invalid URL (http://www.billboard.com/music/p!nk/chart-history/billboard-200).

Billboard chart entries

Chart ID	Output	Requirements	Notes
Billboard200	US Billboard 200	artist
BillboardAlbumSales	US Top Album Sales (Billboard)	artist
BillboardDigital	US Digital Albums (Billboard)	artist
BillboardDanceElectronic	US Top Dance/Electronic Albums (Billboard)	artist
BillboardRandBHipHop	US Top R&B/Hip-Hop Albums (Billboard)	artist
BillboardRandB	US Top R&B Albums (Billboard)	artist
BillboardRap	US Top Rap Albums (Billboard)	artist
BillboardRock	US Top Rock Albums (Billboard)	artist
BillboardAlternative	US Top Alternative Albums (Billboard)	artist
BillboardHardRock	US Top Hard Rock Albums (Billboard)	artist
BillboardFolk	US Top Folk Albums (Billboard)	artist
BillboardCountry	US Top Country Albums (Billboard)	artist
BillboardBluegrass	US Top Bluegrass Albums (Billboard)	artist
BillboardJazz	US Top Jazz Albums (Billboard)	artist
BillboardContemporaryJazz	US Top Contemporary Jazz Albums (Billboard)	artist
BillboardBlues	US Top Blues Albums (Billboard)	artist
BillboardClassical	US Top Classical Albums (Billboard)	artist
BillboardClassicalCrossover	US Top Classical Crossover Albums (Billboard)	artist
BillboardLatin	US Top Latin Albums (Billboard)	artist
BillboardRegionalMexican	US Regional Mexican Albums (Billboard)	artist
BillboardLatinPop	US Latin Pop Albums (Billboard)	artist
BillboardTropical	US Tropical Albums (Billboard)	artist
BillboardChristian	US Christian Albums (Billboard)	artist
BillboardGospel	US Top Gospel Albums (Billboard)	artist
BillboardHoliday	US Top Holiday Albums (Billboard)	artist
BillboardHeatseekers	US Heatseekers Albums (Billboard)	artist
BillboardIndependent	US Independent Albums (Billboard)	artist
BillboardCatalog	US Top Catalog Albums (Billboard)	artist
BillboardReggae	US Top Reggae Albums (Billboard)	artist
BillboardWorld	US World Albums (Billboard)	artist
BillboardComedy	US Top Comedy Albums (Billboard)	artist
BillboardSoundtrack	US Soundtrack Albums (Billboard)	artist
BillboardTastemaker	US Top Tastemaker Albums (Billboard)	artist
BillboardVinyl	US Top Vinyl Albums (Billboard)	artist
BillboardCanada	Canadian Albums (Billboard)	artist
BillboardLatinRhythm	US Latin Rhythm Albums (Billboard)	artist
BillboardCurrentAlbums	US Top Current Album Sales (Billboard)	artist

Music DVD charts

The following Chart IDs are for Music DVDs. These are different from Live albums and some charts defines them separately. The editor must be extremely careful with the naming when using some of the following IDs.

Music DVD sales charts

Chart ID	Output	Website used as archive	Req.	Notes
AustraliaMV	Australian Music DVD (ARIA)	www.ariacharts.com.au	artist dvd archiveurl archivedate	This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the URL [2] with either WebCite or any other archiving method. Then, providing the parameters needed on the template. On archiveurl the WebCite URL must be written, and on url the original given above.
AustriaMV	Austrian Music DVD (Ö3 Austria)	www.austriancharts.at	date	The date parameter must be provided in the DD-MM-YYYY format.
FlandersMV	Belgian Music DVD (Ultratop Flanders)	www.ultratop.be	artist album dvd or year date startdate	Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). In that case, use the dvd parameter instead of the album parameter. Alternatively, if the title has a special character that cannot be hyperlinked to, you can reference an archived version of the DVD chart by providing the year and the date (in YYYYMMDD format). The startdate parameter is the same date as the date parameter but in a different format for purposes of the reference's hyperlink text; startdate should be in a "DD/MM/YYYY" format.
WalloniaMV	Belgian Music DVD (Ultratop Wallonia)	www.ultratop.be	artist album dvd or year date startdate	Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). In that case, use the dvd parameter instead of the album parameter. Alternatively, if the title has a special character that cannot be hyperlinked to, you can reference an archived version of the DVD chart by providing the year and the date (in YYYYMMDD format). The startdate parameter is the same date as the date parameter but in a different format for purposes of the reference's hyperlink text; startdate should be in a "DD/MM/YYYY" format.
DenmarkMV	Danish Music DVD (Hitlisten)	www.hitlisten.nu	week year
FinlandMV	Finnish Music DVD (Suomen virallinen lista)	www.ifpi.fi	artist album
FranceMV	French Music DVD (SNEP)	www.chartsinfrance.net	artist dvd id	The id parameter can be found searching on the archive before selecting the year: For example http://www.chartsinfrance.net/charts/1544/videos-musicales.php.
ItalyMV	Italian Music DVD (FIMI)	www.fimi.it	year week startdate enddate	The startdate and enddate parameters are for purposes of the reference's hyperlink text. They are in a "DD.MM.YYYY" format.
IrelandMV	Irish Music Videos (OCC)	www.officialcharts.com	artist date	Irish Video Chart Top 50 archive from January 6, 2017 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
NetherlandsMV	Dutch Music DVD (MegaCharts)	www.dutchcharts.nl	artist album dvd	Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). In that case, use the dvd parameter instead of the album parameter.
SpainMV	Spanish Music DVD (PROMUSICAE)	www.promusicae.es	year week	The year parameter must contain the year from which the charting took place by scrolling in this URL. The week parameter must be in numbers. Example: 06 for June.
SwedenMV	Swedish Music DVD (Sverigetopplistan)	www.sverigetopplistan.se	year week	The URL contains six numbers, in which the first four digits are the year and the last two are the week. Example: https://www.sverigetopplistan.se/chart/105?dspy=2006&dspp=39
SwitzerlandMV	Swiss Music DVD (Schweizer Hitparade)	www.swisscharts.com	date	The date parameter must be provided in the DD-MM-YYYY format.
UKMV	UK Music Videos (OCC)	www.officialcharts.com	artist date	Music Video Chart Top 50 archive from January 30, 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC.
USMV	US Music Videos (Billboard)	www.billboard.biz	artist date	Music Video Sales chart archive from 1980 onwards. The date parameter must be provided in the YYYY-MM-DD format, which is the issue date that can be found on the URL after clicking here.

Examples with table layout

Example with dummy data

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 an example table with its corresponding output:

<syntaxhighlight lang="wikitext">{| class="wikitable sortable plainrowheaders" |+Example album chart ! scope="col"| Chart ! scope="col"| Peak
position |- ! scope="row"| row 1, cell 1 | row 1, cell 2 |- ! scope="row"| row 2, cell 1 | row 2, cell 2 |- !scope="row"| US Billboard 200 |align="center"|2 |- !scope="row"| US Top Rock Albums (Billboard) |align="center"|1 |}

</syntaxhighlight>

Expands into:

Example album chart

Chart	Peak position
row 1, cell 1	row 1, cell 2
row 2, cell 1	row 2, cell 2
US Billboard 200	2
US Top Rock Albums (Billboard)	1

Example with realistic data

Example using chart data from Homework (Daft Punk album):

<syntaxhighlight lang="wikitext">{| class="wikitable sortable plainrowheaders" |+Chart performance for Homework ! scope="col"| Chart (1997) ! scope="col"| Peak
position |- !scope="row"| Australian Albums (ARIA) |align="center"|37 |- !scope="row"| Norwegian Albums (VG-lista) |align="center"|40 |- !scope="row"| New Zealand Albums (RMNZ) |align="center"|8 |- !scope="row"| Dutch Albums (Album Top 100) |align="center"|25 |- !scope="row"| Austrian Albums (Ö3 Austria) |align="center"|34 |- !scope="row"| Belgian Albums (Ultratop Flanders) |align="center"|7 |- !scope="row"| Belgian Albums (Ultratop Wallonia) |align="center"|9 |- !scope="row"| Canadian Albums (Billboard) |align="center"|15 |- !scope="row"| Finnish Albums (Suomen virallinen lista) |align="center"|34 |- !scope="row"| French Albums (SNEP) |align="center"|3 |- !scope="row"| Swedish Albums (Sverigetopplistan) |align="center"|16 |- !scope="row"| UK Albums (OCC) |align="center"|8 |- !scope="row"| US Billboard 200 |align="center"|150 |}

</syntaxhighlight>

Expands into:

Chart performance for Homework

Chart (1997)	Peak position
Australian Albums (ARIA)	37
Norwegian Albums (VG-lista)	40
New Zealand Albums (RMNZ)	8
Dutch Albums (Album Top 100)	25
Austrian Albums (Ö3 Austria)	34
Belgian Albums (Ultratop Flanders)	7
Belgian Albums (Ultratop Wallonia)	9
Canadian Albums (Billboard)	15
Finnish Albums (Suomen virallinen lista)	34
French Albums (SNEP)	3
Swedish Albums (Sverigetopplistan)	16
UK Albums (OCC)	8
US Billboard 200	150

Tracking category

This template will automatically categorize articles:

• Category:Pages using album chart with unknown parameters (0) – articles with unsupported parameters
• "Album chart usages for X", where X is the chart identifier. This is used to keep track of template usage and to ease maintenance. See Category:Album chart usages (109). Note that alternate names are not handled gracefully, that is, each identifier is categorizes separately.

TemplateData

No description.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
1	1	no description	Unknown	optional
2	2	no description	Unknown	optional
3	3	no description	Unknown	optional
rowheader	rowheader	no description	Unknown	optional
url	url	no description	Unknown	optional
title	title	no description	Unknown	optional
location	location	no description	Unknown	optional
work	work	no description	Unknown	optional
page	page	no description	Unknown	optional
date	date	no description	Unknown	optional
publisher	publisher	no description	Unknown	optional
access-date	access-date	no description	Unknown	optional
accessdate	accessdate	no description	Unknown	optional
artist	artist	no description	Unknown	optional
publish-date	publish-date	no description	Unknown	optional
publishdate	publishdate	no description	Unknown	optional
refname	refname	no description	Unknown	optional
refgroup	refgroup	no description	Unknown	optional
note	note	no description	Unknown	optional
id	id	no description	Unknown	optional
album	album	no description	Unknown	optional
chartid	chartid	no description	Unknown	optional
week	week	no description	Unknown	optional
year	year	no description	Unknown	optional
address	address	no description	Unknown	optional
archiveurl	archiveurl	no description	Unknown	optional
archive-url	archive-url	no description	Unknown	optional
archivedate	archivedate	no description	Unknown	optional
archive-date	archive-date	no description	Unknown	optional
dvd	dvd	no description	Unknown	optional
startdate	startdate	no description	Unknown	optional
enddate	enddate	no description	Unknown	optional

See also

• {{Single chart}} – counterpart of Album chart for chart positions for single releases.

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