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:Year-end album 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 final year-end 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

edit

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)
{{year-end single chart |(Chart identifier) |(Year-end position) |year= |publishdate= |accessdate= |refname= |refgroup= }}

The year parameter is used by default to name references for reuse elsewhere in the article.

Fields

edit

The parameters publishdate, accessdate, refname and refgroup are optional.

  • (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. Named as a country or nationality (e.g., Switzerland or Swiss). Some charts allow more than one identifier; the results produced are identical.
  • (Year-end position) (or second parameter, without name): The number you found to be the year-end position achieved by the single on the specific chart.
  • year: Four-digit year indicating the year being reported by the chart (required). Not necessarily the same as the publication date referred to by publishdate.
  • 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 ye_Chartid_year, 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

edit

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. The right cell contains the year-end 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 {{reflist}} template, like any other references. The reference produced will be given a name in the form "ye_Chartid_year" by default, i.e., if the article uses

{{year-end single chart|Australia|1|year=2018}}

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="ye_Australia_2018"/>

Alternatively, the name can be overridden using the refname parameter, i.e.,

{{year-end single chart|Australia|1|year=2018|refname=ozzychart}}

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=ozzychart/>

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="ozzy chart"/> if you used spaces in the name).

Examples of output with different parameters

edit

A few examples of template usage and the corresponding output are shown here.

Example no. Coding (assumed inside a table row) Output (assumed with <references /> added)
Example 1
{{year-end single chart
  |Australia
  |18
  |year=2018}}
Australia (ARIA)[1] 18
  1. ^ "ARIA Charts - End Of Year Charts - Top 100 Singles 2018" Australian Recording Industry Association.
Example 2
{{year-end single chart
  |hot100
  |5
  |year=2009}}
US Billboard Hot 100[1] 5
Example 3
{{year-end single chart
  |Finland
  |4
  |year=2013}}
Finland (Suomen virallinen lista)[1] 4
  1. ^ The first is the list of the best-selling domestic singles of 2013 in Finland, the second is that of the foreign singles:
Example 4
{| class="wikitable sortable"
! Chart (2009)
! Year-end<br />position
|-
{{year-end single chart |Flanders|16
  |year=2009}}
|-
{{year-end single chart |Wallonia|5
  |year=2009}}
|-
!scope="row"|[[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
|-
{{year-end single chart |Ireland|2 |year=2009}}
|}
Chart (2009) Peak
position
Belgium (Ultratop 50 Flanders)[1] 16
Belgium (Ultratop 50 Wallonia)[2] 5
Brazil Billboard 2009 Year-End Chart[3] 1
Ireland (Irish Singles Chart)[4] 2
  1. ^ "JAAROVERZICHTEN 2009" (in Dutch). Hung Medien.
  2. ^ "RAPPORTS ANNUELS 2009" (in French). Hung Medien.
  3. ^ "Brazil 2009 Year-End Chart" (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-2
  4. ^ "Best of 2009" Irish Recorded Music Association.

Support

edit
Chart ID Actual chart name Website used as archive Required parameters Notes
Australia
Australian
ARIA www.aria.com.au year
Austria
Austrian
Ö3 Austria Top 40 www.austriancharts.at year
Wallonia Belgian Ultratop 50 www.ultratop.be/fr year French language website.
Flanders Belgian Ultratop 50 www.ultratop.be/nl year Dutch language website.
Netherlands
Dutch
Dutch100
Single Top 100 www.dutchcharts.nl year Years 1998 through 2003 show the chart as "Mega Top 100" instead. 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.
Finnish
Finland
Suomen virallinen lista www.ifpi.fi year Expands to 2 bulleted citations, the first being domestic singles, the second being foreign singles.
Ireland
Irish
IRMA www.irma.ie year
Swiss
Switzerland
Schweizer Hitparade www.swisscharts.com year
UK
United Kingdom
GBR
British
Official Charts Company www.officialcharts.com year 2012 has a special name
United States
USA
US
BillboardHot100
Billboardhot100
hot100
Hot100
Billboard Hot 100 www.billboard.com year

See also

edit
  • {{Year-end album chart}} – counterpart of Year-end single chart but for chart positions for music album releases.