This template is used tocite sources in Wikipedia. It is specifically foralbums. A similar template for use when citing sources for musical singles can be found atTemplate: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 areliable 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:
{{Album chart|(Chart identifier)|(Peak position)|artist=|album=|refname=|access-date=30 May 2012|rowheader=true}}
Following, the parameters for anyBillboard chart:
{{Album chart|Billboard(Specific identifier)|(Peak position)|artist=|refname=|access-date=30 May 2012|rowheader=true}}
Following, the parameters for any UK chart (except for the main UK parameter and UKZobbel):
{{Album chart|UK(Specific identifier)|(Peak position)|artist=|date=YYYY-MM-DD|refname=|access-date=30 May 2012|rowheader=true}}
Manual referencing
If the following situations arise:
The album name contains special characters that thealbum= parameter doesn't handle correctly and returns an URL error.
When the template will be used for year-end charts instead of weekly charts.
When the chart position is retrieved from a source other than the default by{{Album chart}} such asBillboard's Chart Beat or Allmusic (remember that all sourcesmust be reliable).
Then a manual reference might be needed. When manual referencing is activated, the usermust provide theurl= andtitle=, and may additionally providework=,page=,date=,location= and (if specially relevant)publisher=, 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:
{{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}}
This mode can be used simultaneously with the normal mode of the template, without the need to change therefname parameter.
The manual referencing modeis not available for the Music DVD charts.
Fields
The parameterspublish-date,access-date, andrefname are optional. Whether the other parameters are required or not depend on the chart being referenced. See the tables in theSupport 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 theSupport 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 thealbum field to correctly work.
artist: Name of the album's performer. As for thealbum 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 therefname parameter, however,artist may not be absolutely necessary.
id: Numeric identifier used by some chart listings (seePolish Music Charts). Determined by performing a search at the chart listings' website for archive chart. Thechartid 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 URLhttp://www.zpav.pl/rankingi/listy/nielsen/top5.php?lang=2&idlisty=532, so thechartid 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 theurl 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 optionalpublish-date parameter.
year: Four-digit year indicating the year being reported by the chart. Used in combination with theweek parameter and only for certain charts; not necessary (or even used) for others. Not necessarily the same as the publication date referred to bypublish-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; consultSupport tables below). Used in combination with theyear parameter and only for certain charts; not necessary (or even used) for others. Not necessarily related to the publication date referred to bypublish-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 otherdates 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 forrefname the default reference name (in the form ac_Chartid_artist) will be used. A reference with a name can bereused 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 withscope=row. This should be present in almost all cases.
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.
This website, instead of retrieving a complete chart history, it returns a weekly chart. Thedate parameter must be filled as this: YYYYMMDD. It contains chart info from 1992 onwards.
Official Irish Albums Chart Top 50 archive from January 6, 2017 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
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.
This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the URL[1] with eitherWebCite 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. Onarchiveurl the WebCite URL must be written.
UK Top 100 Albums archive from 22 July 1956 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Americana albums archive from 29 January 2016 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Compilation albums archive from 6 February 1994 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Country albums archive from 30 January 1994 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Dance albums archive from 25 September 2005 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Digital albums archive from 9 April 2006 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Independent albums archive from 12 October 1997 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Jazz & blues albums archive from 30 January 1994 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Progressive albums archive from 7 October 2015 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
R&B albums archive from 9 October 1994 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Rock & metal albums archive from 9 October 1994 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Soundtrack albums archive from 13 January 2002 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Scottish albums archive from 27 February 1994 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
This uses Zobbel.de.id is the date in the YYMMDD format (supports charts from 15.01.2005 to 30.01.2016); 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 theBillboard 200 for P!nk.
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.
This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the URL[2] with eitherWebCite or any other archiving method. Then, providing the parameters needed on the template. Onarchiveurl the WebCite URL must be written, and onurl the original given above.
Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). In that case, use thedvd parameter instead of thealbum 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 theyear and thedate (in YYYYMMDD format). Thestartdate parameter is the same date as thedate parameter but in a different format for purposes of the reference's hyperlink text;startdate should be in a "DD/MM/YYYY" format.
Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). In that case, use thedvd parameter instead of thealbum 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 theyear and thedate (in YYYYMMDD format). Thestartdate parameter is the same date as thedate parameter but in a different format for purposes of the reference's hyperlink text;startdate should be in a "DD/MM/YYYY" format.
Irish Video Chart Top 50 archive from January 6, 2017 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). In that case, use thedvd parameter instead of thealbum parameter.
Theyear parameter must contain the year from which the charting took place by scrolling inthis URL. Theweek parameter must be in numbers. Example: 06 for June.
Music Video Chart Top 50 archive from January 30, 1994 onwards. Thedate parameter must be provided in the YYYYMMDD format, which is the issue date that can be found onthe archives of the OCC.
USMV
US Music Videos (Billboard)
www.billboard.biz
artist date
Music Video Sales chart archive from 1980 onwards. Thedate parameter must be provided in the YYYY-MM-DD format, which is the issue date that can be found onthe 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:
{|class="wikitable sortable plainrowheaders"|+Chart performance for ''Homework''!scope="col"| Chart (1997)!scope="col"| Peak<br />position|-{{Album chart|Australia|37|artist=Daft Punk|album=Homework|refname=ARIA|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|access-date=30 May 2012|rowheader=true}}|-{{Album chart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Netherlands|25|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Austria|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Flanders|7|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Wallonia|9|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|BillboardCanada|15|artist=Daft Punk|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Finland|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|France|3|refname=FAC|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Sweden|16|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|UK|8|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=true}}|-{{Album chart|Billboard200|150|artist=Daft Punk|access-date=30 May 2012|rowheader=true}}|}{{reflist}}
"Album chart usages for X", where X is the chart identifier. This is used to keep track of template usage and to ease maintenance. SeeCategory:Album chart usages (109). Note that alternate names are not handled gracefully, that is, each identifier is categorizes separately.