Fields edit
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 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 single. 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.
- 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 Output section 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). 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.
- chartid: 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 (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.
- 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.
- 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 publishdate.
- note: For adding a note about a particular version of a song, e.g.,
note=extended dance mix, or{{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=The Bonzo Dog Doo Dah Band|note=uncensored version}}. - publishdate: 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.
- 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.
- 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 sc_Chartid_artist, see Output below) 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.
Manual Referencing edit
If the following situations arise:
- The album name contains special characters that the
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 chart position is retrieved from a source other than the default by
{{albumchart}}such as Billboard's Chart Beat or Allmusic.
Then a manual reference might be needed. When manual referencing is activated, the user must provide the url= and title=, and may additionally provide work=, page=, date=, location= and publisher=, just like on the {{cite news}} template, to add a different source than the commonly used by {{albumchart}}, as this:
{{Albumchart|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|publisher=Nielsen Business Media|location=United States|accessdate=9 June 2012}}
And it will show as this:
| Charts | Peak position |
|---|---|
| Australian Albums (ARIA)[1] | 1 |
- ^ "Madonna's "MDNA" Tops ARIA Charts". Billboard. United States: Nielsen Business Media. 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.