This template is used to cite sources in Wikipedia. It is specifically for recorded musical single releases: singles. A similar template for use when citing sources for musical albums can be found at Template:Albumchart; 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 single 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 a song 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 This template outputs data suitable for inclusion within a record chart table. It will produce a referenced chart name and a position. It can be used as a part of a larger table, or a series of calls can be used to create a chart. This template does not create the surrounding table markup.  All field names used must be in lowercase.  You can copy a blank version to use. Remember to use the "|" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.  The template has the following syntax:   Full version (copy and paste text below and delete parameters you don't need){{singlechart |(Chart identifier) |(Peak position) |song= |songid= |artist= |chartid= |url= |urltitle= |date= |year= |week= |note= |publishdate= |accessdate= |refname= |refgroup= |rowheader=}}  It is a good practice to always include "song=" and "artist=", even though some uses of the template do not require them. This makes it easier to modify the template in the future if there is a change in the archives referenced by the template. In addition, the artist parameter is used by default to name references for reuse elsewhere in the article.  rowheader defaults to false. If set to true, the chart name will be output as a header, as indicated by WP:ACCESS#Data tables.  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 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.  song: 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.  songid: Numeric identifier used by some chart listings (see UKchartstats below). Determined by performing a search at the chart listings' website for the single (or performer or album, then following a link through to the single's page). The songid can be found in the Web address (URL) by inspection. For example, the page for "Genie In A Bottle" at www.chartstats.com has the URL http://www.chartstats.com/songinfo.php?id=27705, so the songid to use is 27705.  artist: Name of the single's performer. As for the song 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: Formerly required for Billboard charts, this parameter is now obsolete.  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.  Output The template's expansion results in two output items:  a row of output for a two-cell table row, and  a reference  The output row includes the piping character to divide the left cell from the right cell. The left cell includes the country and/or chart name, with wikilinks to the chart article(s), as well as the reference note[n] as if it were enclosed in <ref></ref> tags. Any note included with the note parameter is shown in the left cell as well. The right cell contains the peak position number, including the code to horizontally center the number in the table cell.  The citation generated by this template will appear in the list in place of <references /> or the  template, like any other references. The reference produced will be given a name in the form "sc_Chartid_artist" by default, i.e., if the article uses  then the citation could be used to support other statements on the page using a reference as in ...some fact supported by the same source.<ref name="sc_Australia_Bonzo Dog Doo Dah Band"/>  Alternatively, the name can be overridden using the refname parameter, i.e.,  which could then be used as a citation to support other statements on the page using a reference as in ...some fact supported by the same source.<ref name=bonzosinoz/> Note that the refname parameter does not require the use of quotation marks, but names with spaces in them will necessitate quotation marks in the name parameter of <ref> (for example, you would need to use <ref name="bonzos in oz"/> if you used spaces in the name).  Brief examples of output with different parameters A few quick examples of template usage and the corresponding output are shown here. More detailed examples with surrounding table code are in the Examples with table layout section below.   Example no.  Coding (assumed inside a table row)  Output (assumed with <references /> added) Example 1<nowiki>{{singlechart   |Australia   |18   |artist=Shakira   |song=She Wolf}}</nowiki>  Example 2<nowiki> {{singlechart   |Billboardcanadianhot100   |5   |artist=Shakira}}</nowiki>  Example 3<nowiki> {{singlechart   |Frenchdigital   |4   |artist=Shakira   |song=She Wolf   |date=20091017}}</nowiki>  Example 4<nowiki> {{singlechart   |Italy   |3   |artist=Shakira   |song=Loba   |note="Loba" (Spanish version)}} |- {{singlechart   |Italy   |11   |artist=Shakira   |song=She Wolf   |note="She Wolf" (English version)}} </nowiki> Example 5<nowiki> {| class="wikitable sortable" |- ! Chart (2009) ! Peak<br />position |- {{singlechart |Flanders|16   |artist=Shakira |song=She Wolf}} |- {{singlechart |Wallonia|5   |artist=Shakira |song=She Wolf}} |- |[[Billboard Brasil| Brazil ''Billboard'' Hot 100 Airplay]]<ref> "Brazil Hot 100 Airplay" (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-2</ref> | style="text-align:center;"|1 |- {{singlechart |Hungary|5|year=2009|week=14}} |- {{singlechart |Ireland|2 |year=2009 |week=40}} |- {{singlechart |Billboardjapanhot100|9   |artist=Shakira}} |- {{singlechart|Poland|2|year=2013|chartid=532}} |- {{singlechart |UKchartstats|4   |artist=Shakira|song=She Wolf|songid=34525}} |}</nowiki> Chart (2009) PeakpositionBrazil Billboard Hot 100 Airplay"Brazil Hot 100 Airplay" (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-21  Error messages As an aid to template users, certain checks are made to verify that the necessary parameters have been entered. (The actual references are not checked for whether they correctly support the peak position claimed or even if the link is functional, but some parameter entries are checked for appropriateness.) When a check determines that a required parameter is missing, an error message is generated in red. For example, if you forget the week or year value for the Hungary chart, the result in the article will look like: {| class="wikitable" |-  |}  This is an (additional) incentive to preview the article page before saving your edits. Check the charts table as well as the references section for (typically red) error messages.  Support The large number of charts published by Billboard allows for some uniformity in how one accesses their information. However, the other charts and archives used as references on Wikipedia, produced by a multitude of publishers, call for a varied approach when looking up chart positions. Below are two tables, the first for non-Billboard charts, the second for Billboard charts, currently supported by the  template. The parameters necessary to generate reference citations are shown in both tables for each supported chart.  Non-Billboard charts   Chart ID Actual chart name Website used as archive Required parameters NotesAustraliaAustralianARIAwww.australian-charts.comartistsongAustraliapandoraARIApandora.nla.gov.auurlurltitleartist*This forces the use of the National Library of Australia archive for an Australian chart position. This is the only method of retrieving archived positions above 50.AustraliaurbanARIApandora.nla.gov.auurlurltitleartist*This forces the use of the National Library of Australia archive for an Australian chart position. This is the only archive for the Australian Urban chart.AustriaAustrianÖ3 Austria Top 40www.austriancharts.atartistsongBelgium (Wallonia)WalloniaUltratop 50www.ultratop.beartistsongAdding "Tip" after chart name (e.g., "Wallonia Tip") forces Ultratip reference.Belgium (Flanders)FlandersUltratop 50www.ultratop.beartistsongAdding "Tip" after chart name forces Ultratip reference.BulgariaBulgarianIFPI at bamp-br.orgwww.bamp-br.orgurlurltitleartist*The url parameter is validated to point at bamp-br.org. The urltitle parameter should match the title from the page at that url. Unfortunately, the Bulgarian chart cannot be indexed automatically.CanadaadultcontemporaryRPM Adult Contemporary Trackswww.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpmchartidAfter searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.CanadacountryRPM Country Trackswww.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpmchartidAfter searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.CanadadanceRPM Dance/Urbanwww.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpmchartidAfter searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.CanadarockRPM Rock/Alternativewww.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpmchartidAfter searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.CanadatopsinglesRPM Top Singleswww.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpmchartidAfter searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.Czech RepublicČNS IFPI (Rádio Top 100)www.ifpicr.czyearweekartist*Year and week indicate the referenced chart. Week is a number from 01 to 53, with a leading 0 for weeks 01-09. A comment is generated in the reference to show what should be entered in the search table to produce the correct chart. Note that database includes only data since January 2006, thus data for songs released prior to January 2006 are incomplete.CzechdigitalČNS IFPI (Singles Digitál Top 100)DanishDenmarkHitlistenwww.danishcharts.comartistsongWhen year and week are not present, this form (requiring artist and song) will provide a reference pointing to www.danishcharts.com, which may vary from official positions for older songs. Avoid using this form for chart positions before November 2007.www.hitlisten.nuartistsongweekyearOfficial Danish single charts (including prior to November 2007).Denmark 2007Hitlistenwww.hitlisten.nuartistsongweekyearOfficial Danish single charts (including prior to November 2007).Danish AirplayDenmark AirplayHitlistenwww.hitlisten.nuartistsongweekyearOfficial Danish airplay Top 20 charts.Dutch100Mega Single Top 100www.dutchcharts.nlartistsongNote that the table row for this Chart ID will expand as "Netherlands" and may appear incorrectly placed if you position it under "D" in an alphabetically sorted table.Dutch40Dutch Top 40www.top40.nlartistsongWhen year and week are not present, this form (requiring artist and song) will provide a reference pointing to a search results page without positions. Note that the table row for this Chart ID will expand as "Netherlands" and may appear incorrectly placed if you position it under "D" in an alphabetically sorted table.yearweekartist*Year and week indicate the referenced chart. Week is a number from 1 to 53, without a leading 0 for weeks 1-9.Note that the table row for this Chart ID will expand as "Netherlands" and may appear incorrectly placed if you position it under "D" in an alphabetically sorted table.FinnishFinlandSuomen virallinen listawww.ifpi.fiartistsongFinnishdownloadlatauslistaSuomen virallinen latauslistawww.ifpi.fiartistNon-Finnish artists:  If the release has charted on the comprehensive chart above, this chart is to be omitted. Finnish artists:  If the release has charted on the comprehensive chart (above) and not abroad, this chart can be added.FinnishairplayradiosoittolistaSuomen virallinen radiosoittolistawww.ifpi.fiartistNon-Finnish artists:  If the release has charted on the comprehensive chart above (Finnish/Finland), this chart is to be omitted. Finnish artists:  If the release has charted on the comprehensive chart above (Finnish/Finland) and not abroad, this chart can be added.FrenchFranceSNEPwww.lescharts.comartistsongFrenchdigitalSNEPwww.lescharts.comartistsongdateThis forces a reference to the download chart, which is not returned in the summary results. date is an 8 digit number, YYYYMMDDGermanGermanyMedia Control Chartswww.musicline.deartistFor artist use Last,First format.German2Germany2Media Control Chartswww.offiziellecharts.deartistsongidHungaryHungarianMahasz(Rádiós Top 40)www.mahasz.huartistsongyearweekThis is the main, fully indexable Top 40 Radio airplay chart. A link is generated to the individual chart.HungarysingleMahasz(Single Top 40)www.mahasz.huartistsongyearweekA link is generated to the individual chart.HungarydanceMahasz(Dance Top 40)www.mahasz.huartistsongyearweekA link is generated to the individual chart.HungarystreamMahasz(Stream Top 40)www.mahasz.huartistsongyearweekA link is generated to the individual chart.IrelandIrishIRMAwww.chart-track.co.ukyearweekartist*Allowable values for week range from 1 to 53. Single-digit values do not need to be preceded with a 0.Ireland2IRMAirishcharts.ie/artist orsongIf the song parameter is present, it provides a reference pointing to search results for the song, otherwise, it provides a url including search results for the specified artists.ItalianItalyFIMIwww.italiancharts.comartistsongNew ZealandRecorded Music NZwww.charts.org.nzartistsongNorwayVG-listahttp://lista.vg.no/artistsongweekyearWhen year and week are present, this form will provide a reference pointing to lista.vg.no/.PolandPolish Music Chartswww.zpav.plchartidyearPolishdancePolish Dance Chartwww.zpav.plchartidScotlandOfficial Charts Companywww.officialchartcompany.comdateartistsongDate is formatted yyyy-mm-ddSlovakiaSlovakianČNS IFPI (Rádio Top 100)www.ifpicr.czyearweekartist*Year and week indicate the referenced chart. Week is a number from 01 to 53, with a leading 0 for weeks 01-09. A comment is generated in the reference to show what should be entered in the search table to produce the correct chart.SlovakdigitalČNS IFPI (Singles Digitál Top 50)South AfricaEMAwww.sa-ema.comdateDate is formatted yyyy-mm-ddSpainSpanishPROMUSICAEwww.spanishcharts.comartistsongSwedenSwedishSverigetopplistanwww.swedishcharts.comartistsongSwissSwitzerlandSchweizer Hitparadewww.swisscharts.comartistsongUKUnited KingdomOfficial Charts CompanyMain singles chartwww.officialcharts.comdateartistsongDate is formatted yyyy-mm-ddUKsinglesbynameUKchartstatsUKchartarchiveOfficial Charts CompanyMain singles chartwww.officialcharts.comartistsongsongidThis accesses the artist information page on officialcharts.com. The UKchartstats and UKchartarchive values will bring up this same information, as UKchartstats.com no longer publishes chart data due to licensing issues. UKchartstats and UKchartarchive should no longer be used.UKdanceOfficial Charts CompanyDance singles chartwww.officialcharts.comdateartistsongDate is formatted yyyy-mm-ddUKdownloadOfficial Charts CompanyDownload chartwww.officialcharts.comdateartistsongDate is formatted yyyy-mm-ddUKindependentUKindieOfficial Charts Company Independent singles chartwww.officialcharts.comdateartistsongDate is formatted yyyy-mm-ddUKrandbOfficial Charts Company R&B chartwww.officialcharts.comdateartistsongDate is formatted yyyy-mm-ddUKrockUKrockandmetalOfficial Charts Company Rock and metal chartwww.officialcharts.comdateartistsongDate is formatted yyyy-mm-ddOther non-Billboard charts are not currently supported by  and their use will need to be formatted and referenced manually (see the Brazil listing in Example 5 above). Be sure, however, not to use one of the deprecated charts.  * These charts require the artist parameter solely for the purposes of internal reference naming using the default format (see Output above). If you are using the refname parameter to override the default naming, or you are sure that the references are not being reused in the article, you omit artist for the marked charts. The use of song and title are recommended for all charts, however.  Billboard charts Billboard charts all require the artist name.  Chart ID Actual chart name Website used as archive Required parameters NotesBillboardcanadianhot100CanadaCanadian Hot 100www.billboard.comartistBillboardcanadaacCanada ACwww.billboard.comartistBillboardcanadachrtop40Canada CHR/Top 40www.billboard.comartistBillboardcanadacountryCanada Countrywww.billboard.comartistBillboardcanadahotacCanada Hot ACwww.billboard.comartistBillboardcanadarockCanada Rockwww.billboard.comartistBillboardeurodigitalEuro Digital Songswww.billboard.comartistBillboardeuropeanhot100European Hot 100 Singleswww.billboard.comartistBillboardjapanhot100Japan Hot 100www.billboard.comartistLuxembourgdigitalsongsLuxembourg Digital Songswww.billboard.comartistPortugaldigitalsongsPortugal Digital Songswww.billboard.comartistBillboardhot100Billboard Hot 100www.billboard.comartistBillboardbubbling100Bubbling Under Hot 100 Singleswww.billboard.comartistBillboarddigitalsongsDigital Songswww.billboard.comartistBillboardradiosongsRadio Songswww.billboard.comartistBillboardchristiansongsHot Christian Songswww.billboard.comartistBillboardcountrysongsHot Country Songswww.billboard.comartistBillboarddanceelectronicHot Dance/Electronic Songswww.billboard.comartistBillboardlatinsongsHot Latin Songswww.billboard.comartistBillboardrandbhiphopHot R&B/Hip-Hop Songswww.billboard.comartistBillboardrapsongsHot Rap Songswww.billboard.comartistBillboardrocksongsHot Rock Songswww.billboard.comartistBillboardadultalternativesongsAdult Alternative Songswww.billboard.comartistBillboardadultcontemporaryAdult Contemporarywww.billboard.comartistBillboardadultrandbsongsAdult R&B Songswww.billboard.comartistBillboardadultpopsongsAdult Top 40www.billboard.comartistBillboardalternativesongsAlternative Songswww.billboard.comartistBillboardchristianairplayChristian Airplaywww.billboard.comartistBillboardcountryairplayCountry Airplaywww.billboard.comartistBillboarddanceclubplayDance Club Songswww.billboard.comartistBillboarddanceairplayDance/Mix Show Airplaywww.billboard.comartistBillboardlatinairplayLatin Airplaywww.billboard.comartistBillboardlatinpopsongsLatin Pop Songswww.billboard.comartistBillboardmainstreamrockMainstream Rockwww.billboard.comartistBillboardpopsongsMainstream Top 40www.billboard.comartistBillboardrandbhiphopairplayR&B/Hip-Hop Airplaywww.billboard.comartistBillboardregionalmexicanRegional Mexican Airplaywww.billboard.comartistBillboardrhythmicRhythmicwww.billboard.comartistBillboardrockairplayRock Airplaywww.billboard.comartistBillboardsmoothjazzsongsSmooth Jazz Songswww.billboard.comartistBillboardlatintropicalTropical Songswww.billboard.comartistOther Billboard charts are not currently supported by  and their use will need to be formatted and referenced manually (see the Brazil listing in Example 5 above). Be sure, however, not to use one of the deprecated charts.  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 a sample table with its corresponding output:  {| class="wikitable sortable" |- ! Chart ! Peak position |- | row 1, cell 1 | row 1, cell 2 |- | row 2, cell 1 | row 2, cell 2 |-  {{singlechart|Australia|6|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band|note=Happy Meal edition}} |-  {{singlechart|Belgium (Wallonia)|4|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band}} |} <references />  expands into:   Chart Peak position row 1, cell 1 row 1, cell 2 row 2, cell 1 row 2, cell 2    Example with realistic data This example is excerpted from actual usage at Doesn't Mean Anything, with a couple of minor additions. {|class="wikitable sortable" |- !Chart (2009) !Peak<br />position |- {{singlechart|Australia|96|artist=Alicia Keys|song=Doesn't Mean Anything}} |- {{singlechart|Billboardcanadianhot100|66|artist=Alicia Keys}} |- {{singlechart|Czech Republic|31|artist=Alicia Keys|song=Doesn't Mean Anything|year=2010|week=01}} |- {{singlechart|Billboardeuropeanhot100|10|artist=Alicia Keys}} |- {{singlechart|Germany|8|artist=Keys,Alicia|song=Doesn't Mean Anything|note=Angela Merkel rap edition}} |- {{singlechart|Billboardjapanhot100|3|artist=Alicia Keys}} |- {{singlechart|Dutch100|43|artist=Alicia Keys|song=Doesn't Mean Anything|accessdate=2010-02-28}} |- {{singlechart|New Zealand|22|artist=Alicia Keys|song=Doesn't Mean Anything}} |- {{singlechart|Slovakia|31|artist=Alicia Keys|song=Doesn't Mean Anything|week=52|year=2009}} |- {{singlechart|UKchartstats|8|artist=Alicia Keys|song=Doesn't Mean Anything|songid=34669}} |- {{singlechart|Billboardhot100|60|artist=Alicia Keys}} |- {{singlechart|Billboardrandbhiphop|14|artist=Alicia Keys}} |}  <references />  expands into:  Chart (2009)Peakposition  Maintenance categories To help maintain music articles, this template will automatically categorize articles that call it based on the parameters used in the reference.  Singlechart used with missing parameters  contains a list of articles that have failed error checking because of missing parameters.  Singlechart usages for chartname This set of categories lists the calls for each possible chart name, i.e.  contains all articles that have used the template to build a reference for the Billboard Hot 100. Note that alternate names are not handled gracefully:  and  are separate categories.   Invalid artist  This template will automatically categorize articles with invalid artist names in :Category:Articles using Billboard ID with invalid artist. An invalid artist name is one that the template is unable to find in the  subtemplate corresponding to the first letter in that artist's name. See the documentation for  for instructions on how to fix this error.  Template data  See also   – counterpart of Singlechart but for chart positions for music album releases.