Difference between revisions of "Template:Album chart/doc"

From blackwiki
Jump to navigation Jump to search
blackwiki>Mogism
m (Typo fixing and cleanup, typos fixed: Achive → Achieve, carefull → careful, dvd → DVD (8) using AWB (8414))
m (258 revisions imported)
 
(123 intermediate revisions by 50 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
 
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
+
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
 +
{{High-use|10,000}}
 +
{{Lua|Module:WLink|Module:String|Module:Check for unknown parameters}}
  
This template is used to [[WP:CITE|cite sources]] in Wikipedia. It is specifically for [[album]]s. A similar template for use when citing sources for musical singles can be found at [[Template:Singlechart]]; however, for EPs or other releases, it has not yet been developed.
+
This template is used to [[WP:CITE|cite sources]] in Wikipedia. It is specifically for [[album]]s. 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.
 
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.
Line 12: Line 14:
 
Following, the most common parameters used on the template:
 
Following, the most common parameters used on the template:
  
:<code><nowiki>{{albumchart|(Chart identifier)|(Peak position)|artist=|album=|refname=|accessdate=30 May 2012}}</nowiki></code>
+
:{{code|<nowiki>{{Album chart|(Chart identifier)|(Peak position)|artist=|album=|refname=|access-date=30 May 2012|rowheader=yes}}</nowiki>}}
  
 
Following, the parameters for any ''Billboard'' chart:
 
Following, the parameters for any ''Billboard'' chart:
 
   
 
   
:<code><nowiki>{{albumchart|Billboard(Specific identifier)|(Peak position)|artist=|artistid=|refname=|accessdate=30 May 2012}}</nowiki></code>
+
:{{code|<nowiki>{{Album chart|Billboard(Specific identifier)|(Peak position)|artist=|refname=|access-date=30 May 2012|rowheader=yes}}</nowiki>}}
  
Following, the parameters for any UK chart (except for the main UK parameter, UKChartStats and UKZobble):
+
Following, the parameters for any UK chart (except for the main UK parameter and UKZobbel):
 
   
 
   
:<code><nowiki>{{albumchart|UK(Specific identifier)|(Peak position)|artist=|date=YYYY-MM-DD|refname=|accessdate=30 May 2012}}</nowiki></code>
+
:{{code|<nowiki>{{Album chart|UK(Specific identifier)|(Peak position)|artist=|date=YYYY-MM-DD|refname=|access-date=30 May 2012|rowheader=yes}}</nowiki>}}
  
==Manual Referencing==
+
==Manual referencing==
 
If the following situations arise:
 
If the following situations arise:
#The album name contains special characters that the <code>album=</code> parameter doesn't handle correctly and returns an url error.
+
#The album name contains special characters that the {{code|album=}} 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 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 {{tlc|albumchart}} such as ''Billboard'''s Chart Beat or Allmusic (remember that all sources ''must'' be reliable).
+
#When the chart position is retrieved from a source other than the default by {{tlc|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 <code>url=</code> and <code>title=</code>, and may additionally provide <code>work=</code>, <code>page=</code>, <code>date=</code>, <code>location=</code> and <code>publisher=</code>, just like on the {{tlc|cite news}} template, to add a different source than the commonly used by {{tlc|albumchart}}.
+
Then a manual reference might be needed. When manual referencing is activated, the user ''must'' provide the {{code|url=}} and {{code|title=}}, and may additionally provide {{code|work=}}, {{code|page=}}, {{code|date=}}, {{code|location=}} and (if specially relevant) {{code|publisher=}}, just like on the {{tlc|cite news}} template, to add a different source than the commonly used by {{tlc|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:
 
'''To activate manual referencing''', write an "M" as the third parameter of the template, after the country name and chart position, as this:
*<code><nowiki>{{Albumchart|Australia|1|</nowiki>'''<nowiki>M|title=Madonna's "MDNA" Tops ARIA Charts|url=http://www.billboard.com/#/news/madonnas-mdna-tops-aria-charts-1584845.story|work=Billboard|publisher=Nielsen Business Media|location=United States</nowiki>'''<nowiki>|accessdate=9 June 2012}}</nowiki></code>
+
*{{code|<nowiki>{{Album chart|Australia|1|</nowiki>'''<nowiki>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</nowiki>'''<nowiki>|access-date=9 June 2012|rowheader=yes}}</nowiki>}}
And it will show as this:
+
And it will show in a table as this:
 
{| class="wikitable"
 
{| class="wikitable"
!Charts
+
|+Sales chart positions for ''MDNA''
!Peak<br>position
+
!scope="col"|Charts
|-
+
!scope="col"|Peak
{{Albumchart|Australia|1|M|title=Madonna's "MDNA" Tops ARIA Charts|url=http://www.madonna.com/|work=Billboard|publisher=Nielsen Business Media|location=United States|accessdate=9 June 2012}}
 
 
|-
 
|-
 +
{{Album chart|Australia|1|M|title=Madonna's "MDNA" Tops ARIA Charts|url=http://www.madonna.com/|work=Billboard|location=United States|access-date=9 June 2012|rowheader=yes}}
 
|}
 
|}
 
<references />
 
<references />
Line 44: Line 46:
  
 
==Fields==
 
==Fields==
The parameters ''publishdate'', ''accessdate'', and ''refname'' are optional. Whether the other parameters are required or not depend on the chart being referenced. See the tables in the [[#Supports|Support]] section below.
+
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 [[#Supports|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 [[#Supports|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.
 
* '''(Chart identifier)''' (or first parameter, without name): Chart identifier. Must be one of the options listed under Chart ID in the tables of the [[#Supports|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 (&ndash;, not a hyphen -). Usually, it's better to omit the template completely.
 
* '''(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 (&ndash;, not a hyphen -). Usually, it's better to omit the template completely.
Line 50: Line 52:
 
* '''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.
 
* '''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.
 
* '''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.
* '''artistid''': Numeric identifier used by some chart listings (see [[#Billboard_charts|''Billboard'' charts]]). Determined by performing a search at the chart listings' website for the artist (or single or album, ''then'' following a link through to the performer's page). The ''artistid'' can be found in the Web address (URL) by inspection. For example, the page for Eric Clapton at www.billboard.com has the URL http://www.billboard.com/#/artist/eric-clapton/50403, so the ''artistid'' to use is 50403.
 
 
* '''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.
 
* '''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.
 
* '''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.
 
* '''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 (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 ''publishdate'' parameter.
+
* '''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 ''publishdate''.
+
* '''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 [[#Supports|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 ''publishdate''.
+
* '''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 [[#Supports|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., <code>note=2-disc deluxe edition</code>, or <code><nowiki>{{albumchart|Australia|1|album=Making Mirrors|artist=Gotye|note=2-disc deluxe edition}}</nowiki></code>.
+
* '''note''': For adding a note about a particular version of an album, e.g., <code>note=2-disc deluxe edition</code>, or <code><nowiki>{{Album chart|Australia|1|album=Making Mirrors|artist=Gotye|note=2-disc deluxe edition}}</nowiki></code>.
* '''publishdate''': Date of publication of the reference generated by the template, in the same format as other [[WP:DATES#Dates|dates]] in citations in the same article. Optional parameter.
+
* '''publish-date''': Date of publication of the reference generated by the template, in the same format as other [[MOS:DATES#Dates|dates]] in citations in the same article. Optional parameter.
* '''accessdate''': Date that the reference generated by the template was retrieved to determine peak position. Should be 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 [[WP:NAMEDREFS|reused]] for claims elsewhere in the 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 [[WP:NAMEDREFS|reused]] for claims elsewhere in the article. Optional parameter.
 
* '''refgroup''': Enables you to specify a name for the reference group. 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 {{code|1=scope=row}}. This should be present in almost all cases.
  
 
== Supports ==
 
== Supports ==
 
=== National charts ===
 
=== National charts ===
{| class="wikitable" border="1"
+
{| class="wikitable sortable" border="1"
! style="width:10em;"| Chart ID
+
|+Supported international charts
! style="width:20em;"| Output
+
! scope="col"| Chart ID
! style="width:15em;"| Website used as archive
+
! scope="col"| Output
! style="width:7em;"| Req.
+
! scope="col" class="unsortable" | Website used as archive
! style="width:35em;"| Notes
+
! scope="col" class="unsortable" | Req.
 +
! scope="col" class="unsortable" | Notes
 +
|-
 +
!scope="row"| Argentina
 +
| Argentinian Albums ([[CAPIF]]) ||align="center"| adminlic.capif.org.ar ||align="center"| artist<br>album<br>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.
 +
|-
 +
!scope="row"| Australia
 +
| Australian Albums ([[ARIA Charts|ARIA]]) ||align="center"| www.australian-charts.com ||align="center"| artist<br>album ||
 +
|-
 +
!scope="row"| Austria
 +
| Austrian Albums ([[Ö3 Austria Top 40|Ö3 Austria]]) ||align="center"| www.austriancharts.at ||align="center"| artist<br> album ||
 +
|-
 +
!scope="row"| Flanders
 +
| Belgian Albums ([[Ultratop]] Flanders) ||align="center"| www.ultratop.be ||align="center"| artist<br> album ||
 +
|-
 +
!scope="row"| Wallonia
 +
| Belgian Albums ([[Ultratop]] Wallonia) ||align="center"| www.ultratop.be ||align="center"| artist<br> album ||
 +
|-
 +
!scope="row"| Brazil
 +
| Brazilian Albums ([[Pro-Música Brasil|PMB]]) ||align="center"| www.abpd.org.br ||align="center"| id || ''id'' is the last 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
 +
|-
 +
!scope="row"| Canada
 +
| Canada Top Albums/CDs (''RPM'') ||align="center"| www.bac-lac.gc.ca/ || align="center" | chartid || ''chartid'' is the number present after nlcxxxxx.<br> For example in [http://www.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpm/Pages/image.aspx?Image=nlc008388.2647&URLjpg=http%3a%2f%2fwww.collectionscanada.gc.ca%2fobj%2f028020%2ff4%2fnlc008388.2647.gif&Ecopy=nlc008388.2647 this example], the chartid is 2647.
 +
|-
 +
!scope="row"| CroatiaCombined
 +
| Croatian Albums ([[Top of the Shops|HDU]]) ||align="center"| www.hdu-toplista.com ||align="center"| id || ''id'' is the last number(s) at the end of the URL.<br> For example, the id of http://www.hdu-toplista.com/index.php?what=arhiva&w=details&id=1562 is 1562
 
|-
 
|-
| Argentina || Argentinian Albums ([[CAPIF]]) ||align="center"| adminlic.capif.org.ar ||align="center"| artist<br>album<br>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.
+
!scope="row"| Croatia
 +
| Croatian International Albums ([[Top of the Shops|HDU]]) ||align="center"| www.hdu-toplista.com ||align="center"| id || ''id'' is the last number(s) at the end of the URL.<br> For example, the id of http://www.hdu-toplista.com/index.php?what=arhiva&w=details&id=881 is 881
 
|-
 
|-
| Australia || Australian Albums ([[ARIA Charts|ARIA]]) ||align="center"| www.australian-charts.com ||align="center"| artist<br>album ||  
+
!scope="row"| Czech
 +
| Czech Albums ([[IFPI|ČNS IFPI]]) ||align="center"| www.ifpicr.cz ||align="center"| artist<br>album<br>date || ''date'' exact date included on the chart page, e.g. YYYYMMDD. It usually appears at the right of the word "Týden".
 
|-
 
|-
| Austria || Austrian Albums ([[Ö3 Austria Top 40|Ö3 Austria]]) ||align="center"| www.austriancharts.at ||align="center"| artist<br> album ||  
+
!scope="row"| Denmark
 +
| Danish Albums ([[Hitlisten]]) ||align="center"| www.danishcharts.com ||align="center"| artist<br>album || Not recommended for charts prior to Nov. 2007; use instead '''Denmark2'''.
 
|-
 
|-
| Flanders || Belgian Albums ([[Ultratop]] Flanders) ||align="center"| www.ultratop.be ||align="center"| artist<br> album ||  
+
!scope="row"| Denmark2
 +
| Danish Albums ([[Hitlisten]]) ||align="center"| www.hitlisten.nu ||align="center"| week<br>year || For album charts prior to Nov. 2007, is better to use this Chart ID.
 
|-
 
|-
| Wallonia || Belgian Albums ([[Ultratop]] Wallonia) ||align="center"| www.ultratop.be ||align="center"| artist<br> album ||  
+
!scope="row"| Finland
 +
| Finnish Albums ([[The Official Finnish Charts|Suomen virallinen lista]]) ||align="center"| www.ifpi.fi ||align="center"| artist<br>album ||  
 
|-
 
|-
| Brazil || Brazilian Albums ([[Associação Brasileira dos Produtores de Discos|ABPD]]) ||align="center"| www.abpd.org.br ||align="center"| id || ''id'' is the last 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
+
!scope="row"| France
 +
| French Albums ([[Syndicat National de l'Édition Phonographique|SNEP]]) ||align="center"| www.lescharts.com ||align="center"| artist<br>album ||  
 
|-
 
|-
| Croatia || Croatian Foreign Albums ([[Croatian Albums Chart|IFPI]]) ||align="center"| www.hdu-toplista.com ||align="center"| id || ''id'' is the last number(s) at the end of the URL.<br> For example the id of http://www.hdu-toplista.com/index.php?what=arhiva&w=details&id=881 is 881
+
!scope="row"| {{deltext|Germany}}
 +
| German Albums ([[GfK Entertainment Charts|Offizielle Top 100]]) ||align="center"| www.musicline.de ||align="center"| artist<br>album || Obsolete. {{deltext|As with ''Billboard'' charts, this URL returns the complete album (''longplay'') chart history for the selected artist.}}
 
|-
 
|-
| Denmark || Danish Albums ([[Hitlisten]]) ||align="center"| www.danishcharts.com ||align="center"| artist<br>album || Not recommended for charts prior to Nov. 2007; use instead '''Denmark2'''.
+
!scope="row"| {{deltext|Germany2}}
 +
| German Albums ([[GfK Entertainment Charts|Offizielle Top 100]]) ||align="center"| www.officialcharts.de ||align="center"| year<br>date || rowspan=2 | Obsolete {{deltext|This website, instead of retrieving a complete chart history, it returns a weekly chart. <br/>The ''date'' parameter must be filled as this: YYYYMMDD. It contains chart info from 1978 onwards.}}
 
|-
 
|-
| Denmark2 || Danish Albums ([[Hitlisten]]) ||align="center"| www.hitlisten.nu ||align="center"| week<br>year || For albm charts prior to Nov. 2007, is better to use this Chart ID.
+
!scope="row"| {{deltext|Germany3}}
 +
| German Albums ([[GfK Entertainment Charts|Offizielle Top 100]]) ||align="center"| www.officialcharts.de ||align="center"| artist<br>album
 
|-
 
|-
| Finland || Finnish Albums ([[Musiikkituottajat – IFPI Finland|Musiikkituottajat]]) ||align="center"| www.finnishcharts.com ||align="center"| artist<br>album ||  
+
!scope="row"| Germany4
 +
| German Albums ([[GfK Entertainment Charts|Offizielle Top 100]]) ||align="center"| www.offiziellecharts.de ||align="center"| id<br>artist<br>album || ''id'' is the last number(s) at the end of the URL.<br> For example, the id of https://www.offiziellecharts.de/album-details-233637 is 233637
 
|-
 
|-
| France || French Albums ([[SNEP]]) ||align="center"| www.lescharts.com ||align="center"| artist<br>album ||  
+
!scope="row"| GermanyComp
 +
| German Compilation Albums ([[GfK Entertainment Charts|Offizielle Top 100]]) ||align="center"| www.charts.de ||align="center"| year<br>date || This website, instead of retrieving a complete chart history, it returns a weekly chart. <br/>The ''date'' parameter must be filled as this: YYYYMMDD. It contains chart info from 1992 onwards.
 
|-
 
|-
| Germany || German Albums ([[Media Control]]) ||align="center"| www.musicline.de ||align="center"| artist<br>album || As with ''Billboard'' charts, this url returns the complete album (''longplay'') chart history for the selected artist.
+
!scope="row"| Greece
 +
| Greek Albums ([[IFPI Greece|IFPI]]) ||align="center"| www.greekcharts.com ||align="center"| artist<br>album || This website only contains chart information from 2010 to week 31/2011.
 
|-
 
|-
| Germany2 || German Albums ([[Media Control]]) ||align="center"| www.charts.de ||align="center"| year<br>date || This website, instead of retrieving a complete chart history, it returns a weekly chart. <br/>The ''date'' parameter must be filled as this: YYYYMMDD. It contains chart info from 1978 onwards.
+
!scope="row"| Hungary
 +
| Hungarian Albums ([[Association of Hungarian Record Companies|MAHASZ]]) ||align="center"| www.mahasz.hu ||align="center"| year<br>week ||
 
|-
 
|-
| Germany3 || German Albums ([[Media Control]]) ||align="center"| www.charts.de ||align="center"| artist<br>album ||
+
!scope="row"| HungaryComp
 +
| Hungarian Compilation Albums ([[Association of Hungarian Record Companies|MAHASZ]]) ||align="center"| www.mahasz.hu ||align="center"| year<br>week || Since 2000, under the main albums chart.
 
|-
 
|-
| GermanyComp || German Compilation Albums ([[Media Control]]) ||align="center"| www.charts.de ||align="center"| year<br>date || This website, instead of retrieving a complete chart history, it returns a weekly chart. <br/>The ''date'' parameter must be filled as this: YYYYMMDD. It contains chart info from 1992 onwards.
+
!scope="row"| Italy
 +
| Italian Albums ([[Federazione Industria Musicale Italiana|FIMI]]) ||align="center"| www.italiancharts.com ||align="center"| artist<br>album ||
 
|-
 
|-
| Greece || Greek Albums ([[IFPI]]) ||align="center"| www.greekcharts.com ||align="center"| artist<br>album || This website only contains chart information from 2010 to week 31/2011.
+
!scope="row"| {{deltext|Ireland}}
 +
| Irish Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.chart-track.co.uk ||align="center"| year<br>week || Obsolete {{Deltext|Only from 2000 to 2016}}
 
|-
 
|-
| Italy || Italian Albums ([[FIMI]]) ||align="center"| www.italiancharts.com ||align="center"| artist<br>album ||
+
!scope="row"| Ireland2
 +
| Irish Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.irish-charts.com ||align="center"| artist ||
 
|-
 
|-
| Ireland || Irish Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.chart-track.co.uk  ||align="center"| year<br>week ||
+
!scope="row"| Ireland3
 +
| Irish Albums ([[Official Charts Company|OCC]]) ||align="center"| www.officialcharts.com ||align="center"| artist<br>date || Official Irish Albums Chart Top 50 archive from January 6, 2017 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/irish-albums-chart/ the archives of the OCC].
 
|-
 
|-
| Ireland2 || Irish Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.irishcharts.com  ||align="center"| artist<br>album ||
+
!scope="row"| {{Deltext|IrelandClassical}}
 +
| Irish Classical Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.chart-track.co.uk ||align="center"| year<br>week || Obsolete
 
|-
 
|-
| IrelandClassical || Irish Classical Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.chart-track.co.uk ||align="center"| year<br>week ||
+
!scope="row"| {{deltext|IrelandComp}}
 +
| Irish Compilation Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.chart-track.co.uk ||align="center"| year<br>week || Obsolete
 
|-
 
|-
| Korea || Korean Albums ([[GAON]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| year<br>date || Overall albums (national and foreign). The ''date'' must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from [http://www.gaonchart.co.kr/main/section/album/list.gaon?nationGbn=T the GAON page].
+
!scope="row"| {{deltext|IrelandIndependent}}
 +
| Irish Independent Albums ([[Irish Recorded Music Association|IRMA]]) ||align="center"| www.chart-track.co.uk ||align="center"| year<br>week || Obsolete
 
|-
 
|-
| KoreaNat || Korean National Albums ([[GAON]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| year<br>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 [http://www.gaonchart.co.kr/main/section/album/list.gaon?nationGbn=K the GAON page].
+
!scope="row"| Korea
 +
| South Korean Albums ([[Gaon Music Chart|Gaon]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| date || Overall albums (national and foreign). The ''date'' must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from [http://gaonchart.co.kr/main/section/chart/album.gaon?nationGbn=T the Gaon page].
 
|-
 
|-
| KoreaInt || Korean International Albums ([[GAON]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| year<br>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 [http://www.gaonchart.co.kr/main/section/album/list.gaon?nationGbn=E the GAON page].
+
!scope="row"| KoreaNat
 +
| South Korean National Albums ([[Gaon Music Chart|Gaon]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| 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 [http://gaonchart.co.kr/main/section/chart/album.gaon?nationGbn=K the Gaon page].
 
|-
 
|-
| Mexico || Mexican Albums ([[Top 100 Mexico]]) ||align="center"| www.mexicancharts.com ||align="center"| artist<br>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.
+
!scope="row"| KoreaInt
 +
| South Korean International Albums ([[Gaon Music Chart|Gaon]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| 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 [http://gaonchart.co.kr/main/section/chart/album.gaon?nationGbn=E the Gaon page].
 
|-
 
|-
| Mexico2 || Mexican Albums ([[Top 100 Mexico]]) ||align="center"| www.amprofon.com.mx ||align="center"| artist<br>album<br>archiveurl<br>archivedate || This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the url [http://www.centrodedesarrollodigital.com/amprofon3/Top100.pdf] 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.<br/> All parameters are mandatory. Archiving the PDF file or finding the arhived url is highly recommended. On ''archiveurl'' the WebCite url must be written.
+
!scope="row"| Mexico
 +
| Mexican Albums ([[Top 100 Mexico]]) ||align="center"| www.mexicancharts.com ||align="center"| artist<br>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.
 
|-
 
|-
| Netherlands || Dutch Albums ([[MegaCharts]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album ||  
+
!scope="row"| Mexico2
 +
| Mexican Albums ([[Top 100 Mexico]]) ||align="center"| www.amprofon.com.mx ||align="center"| artist<br>album<br>archiveurl<br>archivedate || This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the URL [http://www.centrodedesarrollodigital.com/amprofon3/Top100.pdf] 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.<br/> All parameters are mandatory. Archiving the PDF file or finding the arhived URL is highly recommended. On ''archiveurl'' the WebCite URL must be written.
 
|-
 
|-
| NetherlandsComp || Dutch Compilation Albums ([[MegaCharts]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album<br>year<br>date || For this ID, the ''date'' and ''year'' paramenters are mandatory. ''date'' must be in this format:YYYYMMDD.
+
!scope="row"| Netherlands
 +
| Dutch Albums ([[MegaCharts]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album ||  
 
|-
 
|-
| New Zealand || New Zealand Albums ([[RIANZ]]) ||align="center"| www.charts.org.nz ||align="center"| artist<br>album ||
+
!scope="row"| NetherlandsComp
 +
| Dutch Compilation Albums ([[MegaCharts]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album<br>year<br>date || For this ID, the ''date'' and ''year'' paramenters are mandatory. ''date'' must be in this format:YYYYMMDD.
 
|-
 
|-
| Norway || Norwegian Albums ([[VG-lista]]) ||align="center"| www.norwegiancharts.com ||align="center"| artist<br>album ||
+
!scope="row"| New Zealand
 +
| New Zealand Albums ([[Recorded Music NZ]]) ||align="center"| www.charts.nz ||align="center"| artist<br>album ||
 
|-
 
|-
| Oricon || Japanese Albums ([[Oricon]]) ||align="center"| www.oricon.co.jp ||align="center"| date || This is the Oricon Top 50 Albums chart. It is in Japanese and the only parameter needed is the ''date''.<br> The ''date'' must follow this format: YYYY-MM-DD.
+
!scope="row"| Norway
 +
| Norwegian Albums ([[VG-lista]]) ||align="center"| www.norwegiancharts.com ||align="center"| artist<br>album ||
 
|-
 
|-
| Poland || Polish Albums ([[Polish Society of the Phonographic Industry|ZPAV]]) ||align="center"| olis.onyx.pl ||align="center"| id || ''id'' is the last number(s) at the end of the URL.<br> For example the id of http://olis.onyx.pl/listy/index.asp?idlisty=708 is 708
+
!scope="row"| Oricon
 +
| Japanese Albums ([[Oricon]]) ||align="center"| www.oricon.co.jp ||align="center"| date || This is the Oricon Top 50 Albums chart. It is in Japanese and the only parameter needed is the ''date''.<br> The ''date'' must follow this format: YYYY-MM-DD.
 
|-
 
|-
| Portugal || Portuguese Albums ([[Associação Fonográfica Portuguesa|AFP]]) ||align="center"| www.portuguesecharts.com ||align="center"| artist<br>album ||
+
!scope="row"| Poland
 +
| Polish Albums ([[Polish Society of the Phonographic Industry|ZPAV]]) ||align="center"| olis.onyx.pl ||align="center"| id || ''id'' is the last number(s) at the end of the URL.<br> For example, the id of http://olis.onyx.pl/listy/index.asp?idlisty=708 is 708
 
|-
 
|-
| Switzerland || Swiss Albums ([[Schweizer Hitparade]]) ||align="center"| www.swisscharts.com ||align="center"| artist<br>album ||  
+
!scope="row"| Portugal
 +
| Portuguese Albums ([[Associação Fonográfica Portuguesa|AFP]]) ||align="center"| www.portuguesecharts.com ||align="center"| artist<br>album ||
 
|-
 
|-
| Sweden || Swedish Albums ([[Sverigetopplistan]]) ||align="center"| www.swedishcharts.com ||align="center"| artist<br>album ||  
+
!scope="row"| Switzerland
 +
| Swiss Albums ([[Swiss Music Charts|Schweizer Hitparade]]) ||align="center"| www.swisscharts.com ||align="center"| artist<br>album ||  
 
|-
 
|-
| Spain || Spanish Albums ([[PROMUSICAE]]) ||align="center"| www.spanishcharts.com ||align="center"| artist<br>album ||  
+
!scope="row"| Sweden
 +
| Swedish Albums ([[Sverigetopplistan]]) ||align="center"| www.swedishcharts.com ||align="center"| artist<br>album ||
 +
|-
 +
!scope="row"| Spain
 +
| Spanish Albums ([[Productores de Música de España|PROMUSICAE]]) ||align="center"| www.spanishcharts.com ||align="center"| artist<br>album ||  
 
|-
 
|-
 
|}
 
|}
  
 
=== UK charts ===
 
=== UK charts ===
{| class="wikitable" border="1"
+
{| class="wikitable sortable" border="1"
! style="width:10em;"| Chart ID
+
|+British charts
! style="width:25em;"|Output
+
!scope="col"|Chart ID
! style="width:10em;"|Requirements
+
!scope="col"|Output
! style="width:35em;"|Notes
+
!scope="col"|Requirements
 +
!scope="col"|Notes
 
|-
 
|-
| UK || UK Albums ([[Official Charts Company|OCC]]) ||align="center"| artist || As with ''Billboard'' charts, this url returns the complete album chart history for the selected artist.<br/> Use this parameter only if the album's peak position is higher than 75. For positions below 75, use UKChartStats.
+
!scope="row"| UK
 +
| [[Official Albums Chart|UK Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist || As with ''Billboard'' charts, this URL returns the complete album chart history for the selected artist.
 
|-
 
|-
| UK2 || UK Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || UK Top 40 Albums archive from 1960 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UK2
 +
| [[Official Albums Chart|UK Albums]] ([[Official Charts Company|OCC]]) ||align="center"| date || UK Top 100 Albums archive from 22 July 1956 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/albums-chart/ the archives of the OCC].
 
|-
 
|-
| UKDigital || UK Digital Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Digital albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UKAmericana
 +
| [[Official Americana Albums Chart|UK Americana Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Americana albums archive from 29 January 2016 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/americana-albums-chart/ the archives of the OCC].
 
|-
 
|-
| UKDance || UK Dance Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Dance albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UKComp
 +
| [[UK Compilation Chart|UK Compilation Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Compilation albums archive from 6 February 1994 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/official-compilations-chart/ the archives of the OCC].
 
|-
 
|-
| UKComp || UK Compilation Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Compilation albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UKCountry
 +
| UK Country Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Country albums archive from 30 January 1994 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/country-artists-albums-chart/ the archives of the OCC].
 
|-
 
|-
| UKIndependent || UK Independent Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Independent albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UKDance
 +
| [[ UK Dance Chart|UK Dance Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Dance albums archive from 25 September 2005 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/dance-albums-chart/ the archives of the OCC].
 
|-
 
|-
| UKR&B || UK R&B Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || R&B albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UKDigital
 +
| [[UK Album Downloads Chart|UK Digital Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Digital albums archive from 9 April 2006 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/albums-downloads-chart/ the archives of the OCC].
 
|-
 
|-
| UKCountry || UK Country Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Country albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UKIndependent
 +
| [[UK Indie Chart|UK Independent Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Independent albums archive from 12 October 1997 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/independent-albums-chart/ the archives of the OCC].
 
|-
 
|-
| Scotland || Scottish Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Scottish albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
+
!scope="row"| UKJazz
 +
| UK Jazz & Blues Albums ([[Official Charts Company|OCC]]) ||align="center"| date || Jazz & blues albums archive from 30 January 1994 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/jazz-and-blues-albums-chart/ the archives of the OCC].
 
|-
 
|-
| UKChartStats || UK Albums ([[Official Charts Company|OCC]]) ||align="center"| albumid<br>artist<br>album || This uses ChartStats.com
+
!scope="row"| UKProgressive
 +
| UK Progressive Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Progressive albums archive from 7 October 2015 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/progressive-albums-chart/ the archives of the OCC].
 
|-
 
|-
| UKZobble || UK Albums ([[Official Charts Company|OCC]]) ||align="center"| id<br>title || This uses Zobble.de. ''id'' is the letter (A, B, C, etc.); title is what comes after "Chart Log UK:".
+
!scope="row"| UKR&B
 +
| [[UK R&B Chart|UK R&B Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || R&B albums archive from 9 October 1994 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/r-and-b-albums-chart/ the archives of the OCC].
 +
|-
 +
!scope="row"| UKRock
 +
| [[UK Rock Chart|UK Rock & Metal Albums]] ([[Official Charts Company|OCC]]) ||align="center"| date || Rock & metal albums archive from 9 October 1994 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/rock-and-metal-albums-chart/ the archives of the OCC].
 +
|-
 +
!scope="row"| UKSoundtrack
 +
| UK Soundtrack Albums ([[Official Charts Company|OCC]]) ||align="center"| date || Soundtrack albums archive from 13 January 2002 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/soundtrack-albums-chart/ the archives of the OCC].
 +
|-
 +
!scope="row"| Scotland
 +
| [[Scottish Singles and Albums Charts|Scottish Albums]] ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Scottish albums archive from 27 February 1994 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/scottish-albums-chart/ the archives of the OCC].
 +
|-
 +
!scope="row"| UKZobbel
 +
| UK Albums ([[Official Charts Company|OCC]]) ||align="center"| id<br>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===
''Billboard'' charts all require the artist name and an id number. This can be found by looking up the artist on www.billboard.com. For example, searching for Katy Perry on www.billboard.com will lead to http://www.billboard.com/#/artist/katy-perry/958673 . 958673 is the id number for Katy Perry. This is passed through the ''artistid'' parameter. For example,  
+
''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,  
*{{tlc|albumchart|Billboard200|1|4=artist=Katy Perry|5=artistid=958673}} is the syntax for citing a number 1 position on the ''Billboard'' 200 for Katy Perry.
+
*{{tlc|Album chart|Billboard200|1|4=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.
  
*Also, the artist id can be easily retrieved using the {{tl|BillboardID}} template which, given the artist name, returns the id number without searching the website. With this template, instead of writing:
+
*Entering the artist name as "P!nk" will produced an invalid URL (http://www.billboard.com/music/p!nk/chart-history/billboard-200).
:*{{tlc|albumchart|Billboard200|1|4=artist=Katy Perry|5=artistid=958673}}
 
:We write:
 
:*<code><nowiki>{{albumchart|Billboard200|1|artist=Katy Perry|artistid={{BillboardID|Katy Perry}}}}</nowiki></code>
 
:And the template returns the correct id, avoiding errors when writing the number. {{tl|BillboardID}} is fairly incomplete at this time; be sure to check if the template supports the artist before using it.
 
  
{| class="wikitable" border="1"
+
{| class="wikitable sortable" border="1"
! style="width:15em;"| Chart ID
+
|+''Billboard'' chart entries
! style="width:20em;"| Output
+
!scope="col"| Chart ID
! style="width:10em;"| Requirements
+
!scope="col"| Output
! style="width:25em;"| Notes
+
!scope="col"| Requirements
 +
!scope="col"| Notes
 
|-
 
|-
| Billboard200 || US [[Billboard 200|''Billboard'' 200]] ||align="center"| artist<br/>artistid ||
+
!scope="row"| Billboard200
 +
| US [[Billboard 200|''Billboard'' 200]] ||align="center"| artist ||
 
|-
 
|-
| BillboardDigital || US [[Digital Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardAlbumSales
 +
| US [[Top Album Sales]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardHeatseekers || US [[Top Heatseekers|Heatseekers Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardDigital
 +
| US [[Digital Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardDanceElectronic || US [[Dance/Electronic Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardDanceElectronic
 +
| US [[Top Dance/Electronic Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardRandBHipHop || US [[R&B/Hip-Hop Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardRandBHipHop
 +
| US [[Top R&B/Hip-Hop Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardRap || US [[Rap Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardRandB
 +
| US [[Top R&B Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardRock || US [[Rock Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardRap
 +
| US [[Top Rap Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardAlternative || US [[Alternative Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardRock
 +
| US [[Top Rock Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardHardRock || US [[Hard Rock Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardAlternative
 +
| US [[Top Alternative Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardFolk || US [[Folk Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardHardRock
 +
| US [[Top Hard Rock Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardCountry || US [[Top Country Albums|Country Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardFolk
 +
| US [[Folk Albums|Top Folk Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardBluegrass || US [[Top Bluegrass Albums|Bluegrass Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardCountry
 +
| US [[Top Country Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardJazz || US [[Jazz Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardBluegrass
 +
| US [[Top Bluegrass Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardBlues || US [[Top Blues Albums|Blues Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardJazz
 +
| US [[Top Jazz Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardClassical || US [[Top Classical Albums|Classical Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardContemporaryJazz
 +
| US [[Top Contemporary Jazz Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardLatin || US [[Top Latin Albums|Latin Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardBlues
 +
| US [[Top Blues Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardRegionalMexican || US [[Regional Mexican Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardClassical
 +
| US [[Top Classical Albums]] (''Billboard'') ||align="center"| artist ||
 +
|-
 +
!scope="row"| BillboardClassicalCrossover
 +
| US [[Top Classical Crossover Albums]] (''Billboard'') ||align="center"| artist ||
 +
|-
 +
!scope="row"| BillboardLatin
 +
| US [[Top Latin Albums]] (''Billboard'') ||align="center"| artist ||
 +
|-
 +
!scope="row"| BillboardRegionalMexican
 +
| US [[Regional Mexican Albums]] (''Billboard'') ||align="center"| artist ||
 
|-  
 
|-  
| BillboardLatinPop || US [[Latin Pop Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardLatinPop
 +
| US [[Latin Pop Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardTropical || US [[Tropical Albums]] (''Billboard'') ||align="center"| artist<br/>artistid || Albums before the week of July 5, 2003 are listed on the Tropical Songs chart.
+
!scope="row"| BillboardTropical
 +
| US [[Tropical Albums]] (''Billboard'') ||align="center"| artist ||  
 
|-
 
|-
| BillboardChristian || US [[Christian Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardChristian
 +
| US [[Christian Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardGospel || US [[Top Gospel Albums|Gospel Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardGospel
 +
| US [[Top Gospel Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardIndependent || US [[Independent Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardHoliday
 +
| US [[Top Holiday Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardCatalog || US [[Top Catalog Albums|Catalog Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardHeatseekers
 +
| US [[Heatseekers Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardReggae || US Reggae Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardIndependent
 +
| US [[Independent Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardWorld || US World Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardCatalog
 +
| US [[Top Catalog Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardComedy || US [[Top Comedy Albums|Comedy Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardReggae
 +
| US Top Reggae Albums (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardKids || US [[Kid Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardWorld
 +
| US World Albums (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardSoundtrack || US Soundtrack Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
+
!scope="row"| BillboardComedy
 +
| US [[Top Comedy Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardTastemaker || US Tastemaker Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
+
<!-- | BillboardKids || US [[Kid Albums]] (''Billboard'') ||align="center"| artist || not handled in template -->
 +
|-
 +
!scope="row"| BillboardSoundtrack
 +
| US Soundtrack Albums (''Billboard'') ||align="center"| artist ||
 +
|-
 +
!scope="row"| BillboardTastemaker
 +
| US [[Top Tastemaker Albums]] (''Billboard'') ||align="center"| artist ||
 +
|-
 +
!scope="row"| BillboardVinyl
 +
| US [[Top Vinyl Albums]] (''Billboard'') ||align="center"| artist ||
 +
|-
 +
!scope="row"| BillboardCanada
 +
| [[Canadian Albums Chart|Canadian Albums]] (''Billboard'') ||align="center"| artist ||
 +
|-
 +
<!-- | BillboardNewAge || US New Age Albums (''Billboard'') ||align="center"| artist || not handled in template -->
 +
!scope="row"| BillboardLatinRhythm
 +
| US [[Latin Rhythm Albums]] (''Billboard'') ||align="center"| artist ||
 
|-
 
|-
| BillboardCanada || [[Top Canadian Albums|Canadian Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
 
 
|}
 
|}
  
Line 255: Line 395:
 
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.
 
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.
  
{| class="wikitable" border="1"
+
{| class="wikitable"
! style="width:10em;"| Chart ID
+
|+Music DVD sales charts
! style="width:20em;"| Output
+
!scope="col"| Chart ID
! style="width:15em;"| Website used as archive
+
!scope="col"| Output
! style="width:7em;"| Req.
+
!scope="col"| Website used as archive
! style="width:35em;"| Notes
+
!scope="col"| Req.
 +
!scope="col"| Notes
 
|-
 
|-
| AustraliaMV || Australian DVD Albums ([[ARIA]]) ||align="center"| www.ariacharts.com.au ||align="center"| artist<br>dvd<br>archiveurl<br>archivedate || This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the url [http://www.ariacharts.com.au/pages/charts_display_music.asp?chart=1V40DVD] 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.
+
!scope="row"| AustraliaMV
 +
| Australian Music DVD ([[ARIA Charts|ARIA]]) ||align="center"| www.ariacharts.com.au ||align="center"| artist<br>dvd<br>archiveurl<br>archivedate || This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the URL [http://www.ariacharts.com.au/pages/charts_display_music.asp?chart=1V40DVD] 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 Top 40|Ö3 Austria]]) ||align="center"| www.austriancharts.at ||align="center"| date<br>year || This ID return a weekly top 10. For that reason, the ''date'' and ''year'' paramenters are mandatory. ''date'' must be in this format:YYYYMMDD.
+
!scope="row"| AustriaMV
 +
| Austrian Music DVD ([[Ö3 Austria Top 40|Ö3 Austria]]) ||align="center"| www.austriancharts.at ||align="center"| date || The ''date'' parameter must be provided in the DD-MM-YYYY format.
 
|-
 
|-
| FlandersMV || Belgian Music DVD ([[Ultratop]] Flanders) ||align="center"| www.ultratop.be ||align="center"| artist<br>album<br>dvd || Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). If that happens, use the '''dvd''' parameter instead of the '''album''' parameter.
+
!scope="row"| FlandersMV
 +
| Belgian Music DVD ([[Ultratop]] Flanders) ||align="center"| www.ultratop.be ||align="center"| artist<br>album<br>dvd <br><br>'''or'''<br><br>year<br>date<br>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. <br><br> 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) ||align="center"| www.ultratop.be ||align="center"| artist<br>album<br>dvd || Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). If that happens, use the '''dvd''' parameter instead of the '''album''' parameter.
+
!scope="row"| WalloniaMV
 +
| Belgian Music DVD ([[Ultratop]] Wallonia) ||align="center"| www.ultratop.be ||align="center"| artist<br>album<br>dvd <br><br>'''or'''<br><br>year<br>date<br>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. <br><br> 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.
 
|-
 
|-
| ItalyMV || Italian Music DVD ([[FIMI]]) ||align="center"| www.fimi.it  ||align="center"| year<br>month<br>id || The ''month'' parameter must be in numbers. As an example, February must be written as 02, or June as 06. the ''id'' parameter can be found searching on the Achive before selecting the year and the month: http://www.fimi.it/classifiche_search_dvd.php.
+
!scope="row"| DenmarkMV
 +
| Danish Music DVD ([[Hitlisten]]) ||align="center"| www.hitlisten.nu ||align="center"| week<br>year ||
 
|-
 
|-
| NetherlandsMV || Dutch Music DVD ([[MegaCharts]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album<br>dvd || Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). If that happens, use the '''dvd''' parameter instead of the '''album''' parameter.
+
!scope="row"| FinlandMV
 +
| Finnish Music DVD ([[The Official Finnish Charts|Suomen virallinen lista]]) ||align="center"| www.ifpi.fi ||align="center"| artist<br>album ||
 
|-
 
|-
| SpainMV || Spanish Music DVD ([[PROMUSICAE]]) ||align="center"| www.promusicae.es ||align="center"| year<br>week || The ''year'' parameter must contain ''only the last two numbers of the year''. As an example, if the year is 2011, then only "11" must be written on the parameter. The ''week'' parameter mjst be in numbers. Example: 06.
+
!scope="row"| FranceMV
 +
| French Music DVD ([[Syndicat National de l'Édition Phonographique|SNEP]]) ||align="center"| www.chartsinfrance.net ||align="center"| artist<br>dvd<br>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 http://www.chartsinfrance.net/charts/'''1544'''/videos-musicales.php].
 
|-
 
|-
| UKMV || UK Music Video DVD ([[Official Charts Company]]) ||align="center"| www.officialcharts.com ||align="center"| artist<br>date || Music Video DVD albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/video/ the arhives of the OCC].
+
!scope="row"| ItalyMV
 +
| Italian Music DVD ([[Federazione Industria Musicale Italiana|FIMI]]) ||align="center"| www.fimi.it ||align="center"| year<br>week<br>startdate<br>enddate || The ''startdate'' and ''enddate'' parameters are for purposes of the reference's hyperlink text. They are in a "DD.MM.YYYY" format.
 
|-
 
|-
 +
!scope="row"| IrelandMV
 +
| Irish Music Videos ([[Official Charts Company|OCC]]) ||align="center"| www.officialcharts.com ||align="center"| artist<br>date || Irish Video Chart Top 50 archive from January 6, 2017 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/irish-video-chart/ the archives of the OCC].
 +
|-
 +
!scope="row"| NetherlandsMV
 +
| Dutch Music DVD ([[MegaCharts]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album<br>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.
 +
|-
 +
!scope="row"| SpainMV
 +
| Spanish Music DVD ([[Productores de Música de España|PROMUSICAE]]) ||align="center"| www.promusicae.es ||align="center"| year<br>week || The ''year'' parameter must contain the year from which the charting took place by scrolling in [http://www.promusicae.es/listas/semanales this URL]. The ''week'' parameter must be in numbers. Example: 06 for June.
 +
|-
 +
!scope="row"| SwedenMV
 +
| Swedish Music DVD ([[Sverigetopplistan]]) ||align="center"| www.sverigetopplistan.se ||align="center"| year<br>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
 +
|-
 +
!scope="row"| SwitzerlandMV
 +
| Swiss Music DVD ([[Swiss Hitparade|Schweizer Hitparade]]) ||align="center"| www.swisscharts.com ||align="center"| date || The ''date'' parameter must be provided in the DD-MM-YYYY format.
 +
|-
 +
!scope="row"| UKMV
 +
| UK Music Videos ([[Official Charts Company|OCC]]) ||align="center"| www.officialcharts.com ||align="center"| artist<br>date || Music Video Chart Top 50 archive from January 30, 1994 onwards.<br/> The ''date'' parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on [http://www.officialcharts.com/charts/music-video-chart/ the archives of the OCC].
 +
|-
 +
!scope="row"| USMV
 +
| US Music Videos (''Billboard'') ||align="center"| www.billboard.biz ||align="center"| artist<br>date || Music Video Sales chart archive from 1980 onwards.<br/> The ''date'' parameter must be provided in the YYYY-MM-DD format, which is the issue date that can be found on [http://www.billboard.com/biz/charts/2015-02-07/music-video the URL after clicking here].
 
|}
 
|}
  
 
==Examples with table layout==
 
==Examples with table layout==
 
===Example with dummy data===
 
===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 are examlpes table with its corresponding output:
+
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:
  
 
<pre>{| class="wikitable sortable" border="1"
 
<pre>{| class="wikitable sortable" border="1"
 +
|+Example album chart
 
|-
 
|-
! Chart
+
! scope="col"| Chart
! Peak position
+
! scope="col"| Peak position
 
|-
 
|-
| row 1, cell 1
+
!scope="row"| row 1, cell 1
 
| row 1, cell 2
 
| row 1, cell 2
 
|-
 
|-
| row 2, cell 1
+
!scope="row"| row 2, cell 1
 
| row 2, cell 2
 
| row 2, cell 2
 
|-
 
|-
  {{albumchart|Billboard200|2|artist=Paramore|artistid=683820}}
+
  {{Album chart|Billboard200|2|artist=Paramore|rowheader=yes}}
 
|-
 
|-
  {{albumchart|BillboardRock|1|artist=Paramore|artistid=683820}}
+
  {{Album chart|BillboardRock|1|artist=Paramore|rowheader=yes}}
 
|}
 
|}
  
Line 305: Line 475:
  
 
{| class="wikitable sortable" border="1"
 
{| class="wikitable sortable" border="1"
 +
|+Example album chart
 
|-
 
|-
! Chart
+
! scope="col"| Chart
! Peak position
+
! scope="col"| Peak position
 
|-
 
|-
| row 1, cell 1
+
!scope="row"| row 1, cell 1
 
| row 1, cell 2
 
| row 1, cell 2
 
|-
 
|-
| row 2, cell 1
+
!scope="row"| row 2, cell 1
 
| row 2, cell 2
 
| row 2, cell 2
 
|-
 
|-
  {{albumchart|Billboard200|2|artist=Paramore|artistid=683820}}
+
  {{Album chart|Billboard200|2|artist=Paramore|rowheader=yes}}
 
|-
 
|-
  {{albumchart|BillboardRock|1|artist=Paramore|artistid=683820}}
+
  {{Album chart|BillboardRock|1|artist=Paramore|rowheader=yes}}
 
|}
 
|}
 
<references/>
 
<references/>
Line 325: Line 496:
  
 
<pre>{| class="wikitable sortable plainrowheaders"
 
<pre>{| class="wikitable sortable plainrowheaders"
 +
|+Sales chart performance for ''Homework''
 
|-
 
|-
! Chart (1997)
+
!scope="col"| Chart (1997)
! Peak<br/>position
+
!scope="col"| Peak<br/>position
 
|-
 
|-
|{{albumchart|Australia|37|artist=Daft Punk|album=Homework|refname=ARIA|accessdate=30 May 2012}}
+
{{Album chart|Australia|37|artist=Daft Punk|album=Homework|refname=ARIA|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|accessdate=30 May 2012}}
+
{{Album chart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|accessdate=30 May 2012}}
+
{{Album chart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Netherlands|25|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Netherlands|25|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Austria|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Austria|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Flanders|7|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Flanders|7|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Wallonia|9|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Wallonia|9|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|BillboardCanada|15|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
+
{{Album chart|BillboardCanada|15|artist=Daft Punk|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Finland|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Finland|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|France|3|refname=FAC|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|France|3|refname=FAC|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Sweden|16|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Sweden|16|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|UK|8|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|UK|8|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Billboard200|150|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
+
{{Album chart|Billboard200|150|artist=Daft Punk|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
 
|}
 
|}
Line 362: Line 534:
  
 
{| class="wikitable sortable plainrowheaders"
 
{| class="wikitable sortable plainrowheaders"
 +
|+Sales chart performance for ''Homework''
 
|-
 
|-
! Chart (1997)
+
!scope="col"| Chart (1997)
! Peak<br/>position
+
!scope="col"| Peak<br/>position
 
|-
 
|-
|{{albumchart|Australia|37|artist=Daft Punk|album=Homework|refname=ARIA|accessdate=30 May 2012}}
+
{{Album chart|Australia|37|artist=Daft Punk|album=Homework|refname=ARIA|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|accessdate=30 May 2012}}
+
{{Album chart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|accessdate=30 May 2012}}
+
{{Album chart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Netherlands|25|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Netherlands|25|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Austria|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Austria|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Flanders|7|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Flanders|7|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Wallonia|9|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Wallonia|9|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|BillboardCanada|15|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
+
{{Album chart|BillboardCanada|15|artist=Daft Punk|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Finland|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Finland|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|France|3|refname=FAC|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|France|3|refname=FAC|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Sweden|16|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|Sweden|16|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|UK|8|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
+
{{Album chart|UK|8|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
|{{albumchart|Billboard200|150|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
+
{{Album chart|Billboard200|150|artist=Daft Punk|access-date=30 May 2012|rowheader=yes}}
 
|-
 
|-
 
|}
 
|}
 
<references/>
 
<references/>
 +
 +
== Tracking category ==
 +
This template will automatically categorize articles:
 +
* {{clc|Articles using BillboardChartNum with invalid chart name}} – articles with invalid chart names
 +
* {{clc|Pages using album chart with unknown parameters}} – 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 {{clc|Album chart usages}}. Note that alternate names are not handled gracefully, that is, each identifier is categorizes separately.
  
 
==See also==
 
==See also==
*{{tl|Singlechart}}&nbsp;– counterpart of ''Albumchart'' but for chart positions for single releases.
+
* {{tl|Single chart}}&nbsp;– counterpart of ''Album chart'' for chart positions for single releases.
 
 
  
{{intricate}}
+
<includeonly>{{sandbox other||
 +
<!-- Categories below this line; interwikis at Wikidata -->
 +
[[Category:Music templates]]
 +
[[Category:Templates that add a tracking category]]
 +
[[Category:WikiProject Albums templates]]
 +
[[Category:Templates that generate named references]]
 +
}}</includeonly>

Latest revision as of 15:08, 19 October 2020

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:

{{Album chart|(Chart identifier)|(Peak position)|artist=|album=|refname=|access-date=30 May 2012|rowheader=yes}}

Following, the parameters for any Billboard chart:

{{Album chart|Billboard(Specific identifier)|(Peak position)|artist=|refname=|access-date=30 May 2012|rowheader=yes}}

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=yes}}

Manual referencing

If the following situations arise:

  1. The album name contains special characters that the {{{1}}} 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 {{{1}}} and {{{1}}}, and may additionally provide {{{1}}}, {{{1}}}, {{{1}}}, {{{1}}} and (if specially relevant) {{{1}}}, 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=yes}}

And it will show in a table as this:

Sales chart positions for MDNA
Charts Peak
Australian Albums (ARIA)[1] 1
  1. "Madonna's "MDNA" Tops ARIA Charts". Billboard. United States. Retrieved 9 June 2012.

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 scope=row. 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 last 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 last 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 last 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
date
date exact date included on the chart page, e.g. YYYYMMDD. It usually appears at the right of the word "Týden".
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 last 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.
Italy Italian Albums (FIMI) www.italiancharts.com artist
album
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
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 paramenters 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 last number(s) at the end of the URL.
For example, the id of http://olis.onyx.pl/listy/index.asp?idlisty=708 is 708
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.

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

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:

{| class="wikitable sortable" border="1"
|+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
|-
 {{Album chart|Billboard200|2|artist=Paramore|rowheader=yes}}
|-
 {{Album chart|BillboardRock|1|artist=Paramore|rowheader=yes}}
|}

{{reflist}}

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[1] 2
US Top Rock Albums (Billboard)[2] 1

Example with realistic data

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

{| class="wikitable sortable plainrowheaders"
|+Sales 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=yes}}
|-
{{Album chart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|Netherlands|25|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|Austria|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|Flanders|7|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|Wallonia|9|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|BillboardCanada|15|artist=Daft Punk|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|Finland|34|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|France|3|refname=FAC|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|Sweden|16|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|UK|8|artist=Daft Punk|album=Homework|access-date=30 May 2012|rowheader=yes}}
|-
{{Album chart|Billboard200|150|artist=Daft Punk|access-date=30 May 2012|rowheader=yes}}
|-
|}

{{reflist}}

Expands into:

Sales chart performance for Homework
Chart (1997) Peak
position
Australian Albums (ARIA)[1] 37
Norwegian Albums (VG-lista)[2] 40
New Zealand Albums (RMNZ)[3] 8
Dutch Albums (Album Top 100)[4] 25
Austrian Albums (Ö3 Austria)[5] 34
Belgian Albums (Ultratop Flanders)[6] 7
Belgian Albums (Ultratop Wallonia)[7] 9
Canadian Albums (Billboard)[8] 15
Finnish Albums (Suomen virallinen lista)[9] 34
French Albums (SNEP)[10] 3
Swedish Albums (Sverigetopplistan)[11] 16
UK Albums (OCC)[12] 8
US Billboard 200[13] 150
  1. "Australiancharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
  2. "Norwegiancharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
  3. "Charts.nz – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
  4. "Dutchcharts.nl – Daft Punk – Homework" (in Dutch). Hung Medien. Retrieved 30 May 2012.
  5. "Austriancharts.at – Daft Punk – Homework" (in German). Hung Medien. Retrieved 30 May 2012.
  6. "Ultratop.be – Daft Punk – Homework" (in Dutch). Hung Medien. Retrieved 30 May 2012.
  7. "Ultratop.be – Daft Punk – Homework" (in French). Hung Medien. Retrieved 30 May 2012.
  8. "Daft Punk Chart History (Canadian Albums)". Billboard. Retrieved 30 May 2012.
  9. "Daft Punk: Homework" (in Finnish). Musiikkituottajat – IFPI Finland. Retrieved 30 May 2012.
  10. "Lescharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
  11. "Swedishcharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
  12. "Daft Punk | Artist | Official Charts". UK Albums Chart. Retrieved 30 May 2012.
  13. "Daft Punk Chart History (Billboard 200)". Billboard. Retrieved 30 May 2012.

Tracking category

This template will automatically categorize articles:

See also

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