View source for Wikipedia:Manual of Style/Record charts

{{pp-semi|small=yes}}
{{For|the WikiProject|Wikipedia:WikiProject Record Charts}}
{{Redirect|WP:USCHART|information about ''Billboard'' charts|WP:USCHARTS}}
{{style-guideline|MOS:CHARTS|WP:MUSIC/TABLE|WP:MUSIC/CHARTS}}
{{style}}

This page serves as a guideline for formatting tables of [[record chart]] information in music-related articles. Specifics about which charts should be included are common to the tables, article prose, and discography tables, and guidance about what charts to include may be found in [[WP:Record charts]]. 

The chart positions should be organized into one table, and the table should be formatted using <code>class="wikitable sortable"</code>.

Charts should be arranged by country in alphabetical order.

The only exception to this rule is when there is a very specific reason, such as charts representing the home country of the artist or composer (this can mean country of origin, country of residence, official nationality or any country where the artist or composer has lived for a substantial part of their lives) or releases with a strong link to the country in question (e.g. [[Eurovision]] entries).

Within the table, charts should be properly named as listed by the source and peaks should not appear boldfaced, as this violates Wikipedia's policy regarding [[Wikipedia:Neutral point of view|neutral point of view]] and breaches [[WP:MOSBOLD]]. Flag icons should not be displayed on chart tables, as per [[MOS:INFOBOXFLAG#Do not emphasize nationality without good reason|MOS:FLAG]], nationalities should not be emphasized.

All of these example tables include indicators to show correct location of references. (These are not legitimate references for information contained in this article.) References should be as specific as possible, and generally should be to a URL that will display the exact charting information being included, not simply to the website where the chart may be found. Thus sources should be archived meaning that they can be accessed at later dates. 'Outside' archive sources such as the [[Wayback Machine]] or [[WebCite]] are also acceptable.

Please note that while the charting action is active or ongoing within a specific market area (country), that non-archived reference(s) from reliable sources may be used as it pertains to that specific chart due to the fact it is too early for such information to appear in official archives. Where possible 'outside' archiving is also preferred.

Articles about songs and albums should not include succession boxes that indicate which songs or albums preceded and succeeded it on the top spot of a chart.

== Original (manual) chart format ==
Note that references should be individual and specific to each chart that is being used. Sources per column or table are insufficient. 
{|class="wikitable plainrowheaders sortable" style="text-align:center;" border="1"
!scope="col"|Chart (2008)
!scope="col"|Peak<br />position
|-
!scope="row"|Australian Singles Chart{{Dummy ref|1}}
|1
|-
!scope="row"|Canadian Singles Chart{{Dummy ref|2}}
|2
|-
!scope="row"|French Singles Chart{{Dummy ref|3}}
|3
|-
!scope="row"|German Singles Chart{{Dummy ref|4}}
|4
|-
!scope="row"|Norwegian Singles Chart{{Dummy ref|5}}
|5
|-
!scope="row"|Swiss Singles Chart{{Dummy ref|6}}
|6
|-
!scope="row"|UK Singles Chart{{Dummy ref|7}}
|7
|-
!scope="row"|US ''Billboard'' Hot 100{{Dummy ref|8}}
|8
|-
!scope="row"|US Hot Dance Club Songs{{Dummy ref|9}}
|9
|-
!scope="row"|US Hot R&B/Hip Hop Songs{{Dummy ref|10}}
|10
|}

Albums and singles which peak on different charts during different years are formatted with the charts for the more recent year(s) in a separate table below the earlier table(s):

{|class="wikitable plainrowheaders sortable" style="text-align:center;" border="1"
!scope="col"|Chart (2006)
!scope="col"|Peak<br />position
|-
!scope="row"|Australian Singles Chart{{Dummy ref|11}}
|1
|-
!scope="row"|Canadian Singles Chart{{Dummy ref|12}}
|2
|-
!scope="row"|Spanish Singles Chart{{Dummy ref|13}}
|3
|-
!scope="row"|UK Singles Chart{{Dummy ref|14}}
|4
|-
!scope="row"|US ''Billboard'' Hot 100{{Dummy ref|15}}
|5
|-
!scope="row"|US Alternative Songs{{Dummy ref|16}}
|6
|}

{|class="wikitable plainrowheaders sortable" style="text-align:center;" border="1"
!scope="col" style="width:12em;"|Chart (2007)
!scope="col"|Peak<br />position
|-
!scope="row"|Swiss Singles Chart{{Dummy ref|17}}
|7
|}

Note that this often causes the left columns of different tables to have differing widths, which makes the tables harder to read. One approach is to add a width instruction (''e.g.'', <code>style="width:12em;"</code>) for the smaller column to roughly match the width of the larger. See the code for the Chart (2007) table in the above example.

Alternative versions of the same song, such as remixes or radio edits, should be indicated in the table as an additional line  within the Chart name cell:

{|class="wikitable plainrowheaders sortable" style="text-align:center;" border="1"
!scope="col"|Chart (2007)
!scope="col"|Peak<br />position
|-
!scope="row"|Australian Singles Chart{{Dummy ref|18}}
|1
|-
!scope="row"|German Singles Chart{{Dummy ref|19}}
*German radio version
|2
|-
!scope="row"|UK Singles Chart{{Dummy ref|20}}
*Extended dance remix
|3
|-
!scope="row"|US ''Billboard'' Hot 100{{Dummy ref|21}}
|4
|-
!scope="row"|US Mainstream Rock Tracks{{Dummy ref|22}}
|5
|}

== Chart macros ==
The {{tl|singlechart}} template is available for formatting chart tables for single articles. The use of the macro is strongly encouraged, as it automatically creates a correct reference for the chart entry, allows changes to sourcing sites to be accommodated by editing a central location instead of edits across thousands of articles, and will permit future implementation of a bot to assist in vandalism reversion. Documentation on the use of {{tl|singlechart}} is available at the template page.

The macros will look something like this on pages:
{|class="wikitable plainrowheaders sortable" border="1"
!scope="col"|Chart (2008)
!scope="col"|Peak<br />position
|-
{{singlechart|Australia|1|artist=Alicia Keys|song=Doesn't Mean Anything|refgroup=chart|rowheader=true}}
|-
{{singlechart|Billboardcanadianhot100|2|artist=Alicia Keys|artistid=433721|refgroup=chart|rowheader=true}}
|-
{{singlechart|France|3|artist=Alicia Keys|song=Doesn't Mean Anything|refgroup=chart|rowheader=true}}
|-
{{singlechart|Germany|4|artist=Alicia Keys|song=Doesn't Mean Anything|songid=625466|refgroup=chart|rowheader=true}}
|-
{{singlechart|Norway|5|artist=Alicia Keys|song=Doesn't Mean Anything|refgroup=chart|rowheader=true}}
|-
{{singlechart|Swiss|6|artist=Alicia Keys|song=Doesn't Mean Anything|refgroup=chart|rowheader=true}}
|-
{{singlechart|UK|7|artist=Alicia Keys|song=Doesn't Mean Anything|date=2010-02-28|refgroup=chart|rowheader=true}}
|-
{{singlechart|Billboardhot100|8|artist=Alicia Keys|artistid=433721|refgroup=chart|rowheader=true}}
|-
{{singlechart|Billboarddanceclubplay|9|artist=Alicia Keys|artistid=433721|refgroup=chart|rowheader=true}}
|}

The references will look like this:
{{Reflist|group=chart}}

'''Notes'''
*For the German macro you must format the artist name "last,first" and the song must be written like it is on their website for example "I Want to Know What Love Is (2-track)".
*The United States ''Billboard'' charts visually look the same as the original chart format.<!-- Huh? -->
*Although the macros are not compulsory they are not to be reverted if they have been upgraded.
*{{tl|Chart table top}} is also available to format chart table headers. As with {{tl|singlechart}}, instructions on its usage can be found on its template page.

==See also==
* [[Wikipedia:How to use tables]]

{{Record charts}}


[[Category:Wikipedia Manual of Style (music)]]