View text source at Wikipedia
This template is used on approximately 34,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
This template is part of a set of templates used for creating certification tables for albums, singles, etc. Note that WP:ALBUM/CERT recommends the creation of a table only when an album has achieved multiple certifications.
See each of the templates for specific documentation. The template also uses {{cite certification}} for citation, see documentation there.
All the templates support the following common parameters:
|format=
: The size and format of the table. |format=3col
, the default value, will create three columns, namely region, award, and the amount sold for the certification. |format=2col
or |format=2colthin
create two columns, region and award. In the latter case the region column uses a thinner form.The following is a common usage example for the set of templates using the default |format=3col
. Examples using the other formats can be found here.
{{Certification Table Top|caption=Certifications for "Best song Ever"}}
{{Certification Table Entry|region=Finland|title=Best Song Ever|artist=My Band|type=single|award=Gold|salesamount=32,682}}
{{Certification Table Entry|region=France|title=Best Song Ever|artist=My Band|type=single|award=Platinum|certyear=1999|relyear=1998}}
{{Certification Table Entry|region=Germany|title=Best Song Ever|artist=My Band|type=single|award=Platinum|number=2|relyear=1998}}
{{Certification Table Entry|region=United States|title=Best Song Ever|artist=My Band|type=single|award=Platinum|number=2|relyear=1998|certyear=2015}}
{{Certification Table Separator|title=Streaming}}
{{Certification Table Entry|region=Sweden|title=Best Song Ever|artist=My Band|type=single|award=Platinum|certyear=2019|certweek=5|relyear=1998}}
{{Certification Table Summary}}
{{Certification Table Entry|region=Europe|title=Best Song Ever|artist=My Band|award=Platinum|number=4|certyear=1999}}
{{Certification Table Bottom|streaming=true|streamsonly=true}}
Creates:
Region | Certification | Certified units/sales |
---|---|---|
Finland (Musiikkituottajat)[1] | Gold | 32,682[1] |
France (SNEP)[2] | Platinum | 500,000* |
Germany (BVMI)[3] | 2× Platinum | 1,000,000^ |
United States (RIAA)[4] | 2× Platinum | 2,000,000‡ |
Streaming | ||
Sweden (GLF)[5] | Platinum | 8,000,000† |
Summaries | ||
Europe (IFPI)[6] | 4× Platinum | 4,000,000* |
* Sales figures based on certification alone. |
Mandatory
|region=
– region where the work was certified|title=
– title of the work|artist=
– performing artist or group|type=
– album
/single
/video
/jazz
/compilation
/videosingle
/ringtone
/EP
. Not all types supported for all regions, see table below for details|award=
– Diamond
/Platinum
/Gold
/Silver
/Million
/Billion
/Diamond+Platinum
/Diamond+Gold
/Platinum+Gold
/Diamond+Platinum+Gold
. Awards vary by region. See other supported awards for specific regions below.Non-mandatory
|access-date=
– The date in which the source verifying the certification was retrieved, for web sources|date=
– The date of certification|nosales=
– true
if no sales figure is to be displayed|nocert=
– true
if no certification is to be displayed. This can be used to specify sales figured from other sources|certref=
– for specifying a different source for the certification. Enclose with <ref>...</ref>
.|number=
– number of awards given. For example, for Double Platinum enter 2.|number2=
– number of awards given, in case of multiple awards, check for support below|number3=
– number of awards given, in case of multiple awards, check for support below|relyear=
– release year, used to calculate sales|relmonth=
– release month (number), used to calculate sales in some cases|relday=
– release day (number), used to calculate sales in some rare cases|certyear=
– year in which certification was awarded, used for linking and to calculate sales in some cases|certmonth=
– month (number) in which certification was awarded, used to calculate sales in some rare cases|certweek=
– week (number) in which certification was awarded, used for linking and sales calculation in some cases|certday=
– day (number) in which certification was awarded, used to calculate sales in some even rarer cases|salesamount=
– override sales amount with a sales figure from a reliable source, when not based on the certification. It can also be used (temporarily) to override the sales amount if you believe the template is not calculating it correctly, but please let us know so it can be fixed. In both cases, |salesref=
, the reliable source used, is mandatory when using this parameter.|salesref=
– source for overridden sales amount if it is not the certification itself|id=
– external ID required for citation. Explained where relevant|position=
– chart position of work when certification was awarded, used for easing navigation in some cases|multidisc=
– the number of discs in a multi-disc package|source=
– determines the source of the certification, documented where relevant|digital=
– true
for digital downloads certification, check for support below|streamsonly=
– true
for streaming only certification, check for support below|preloaded=
– true
for pre-loaded certification, check for support below|domestic=
– true
for domestic titles, influences certification levels and citation in some regions|Spanish=
– true
for Spanish-speaking albums, see United States below|discount=
– true
for discount albums, influences certification levels in some regions|note=
– Additional notes, e.g. specific edition certified|best=
– see Germany below|archive-url=
–|archive-date=
–|refname=
– enables you to specify a name for a reference automatically generated by the template; note that when the citeref parameter is supplied, this parameter is ignored|footnote=
– Overrides the footnote symbol. Allowed values are sales
/shipments
/streaming
/streamsonly
|nocat=
– 1
turns off the categorizationRegion | Notes | Source for thresholds | Sales/Shipments |
---|---|---|---|
Argentina | Certifications currently unavailable Sales require |relyear= and sometimes |relmonth= .Supports |digital=true for digital single certification and |streamsonly=true for streaming singles.type also can be compilation |
Article | Shipments |
Australia | Use |certyear= to cite the yearly archives from 1990 to 2021To cite ARIA Top 50 charts (from July 2019), set |id= to YYYY-MM-DD, e.g. |id=2019-07-22 . To cite the Australian artist Top 20, set |domestic=true To cite ARIA Top 50 yearly charts (from 1988) set |source=yearchart Can also set |source=book to use Ryan, Gavin (2011). Australia's Music Charts 1988–2010 (PDF ed.). Mt Martha, Victoria, Australia: Moonlight Publishing. and |id= is the page number.Correct sales requires |certyear= . Correct footnotes may require |certmonth= . |
[1] | Shipments→Sales+Streaming |
Austria | Sales require relyear and sometimes relmonth . |
[1][2] | Sales→Sales+Streaming |
Belgium | requires certyear supports |domestic=true Sales require certyear and sometimes certmonth , relyear and relmonth .Unknown thresholds for singles between November 2007 and May 2009. |
[3][4][5][6][7][8][9][10][11] | Sales→Sales+Streaming |
Brazil | Sales require relyear and sometimes relmonth Set |domestic=true for domestic certification. Set |digital=true for album digital certification. |
[12][13][14] | Sales→Sales+Streaming |
Canada | Supports |type=ringtone for ringtone certifications (discontinued in 2021)Sales for albums require relyear and sometimes relmonth .Sales for singles require certyear and sometimes certmonth and certday Set |digital=true only for digital single certification (which were discontinued in 2016)Correct footnote for albums may require certyear and sometimes certmonth and certday |
[15][16][17][18] | Sales/Shipments→Sales+Streaming |
Central America | [19] | Streaming-only | |
Denmark | Specifying |source=chart uses charts, certyear is the chart year and id is the chart week. Otherwise will use the certification database. Specifying id will direct to the "node" (available from the URL after search). Otherwise will direct to the general database, and certyear can be specified for better directions.Sales require certyear and may require certmonth , certday , relyear , relmonth and relday .Supports |streamsonly=true for streaming certifications between January 7, 2011 and November 17, 2014
|
[2] [3] [4] [5] [6] [7] | Shipments/Streaming-only→Sales+Streaming |
Europe | requires certyear Albums only Use only in the summary section |
[20] | Sales |
Finland | Requires |artist= Requires |salesamount= from reported sourceSupports |domestic=true for local artists |
Not used | |
France | Use |source=archive to use SNEP archives as source, requires |certyear= , |award= and |number= for multiple awards.Use |source=infodisc for unofficial www.infodisc.fr tables (Manual search required)type can also be compilation Sales require certyear and may require certmonth |
[21][22][23] | Sales→Sales+Streaming |
GCC | requires certyear . Supports |domestic=true , but without automatic citation. |
[24] | Sales |
Germany | Supports |type=jazz .Sales require |relyear= and sometimes |relmonth= , |relday= or |certyear= . May also use |certyear= and |certmonth= for correct footnotes.In cases where the best certification does not show up (known bug), set |best=no to show the entire certification history |
[25][26][27] | Shipments→Sales+Streaming |
Greece | Referenced from wayback machine archive here require id , the full 14 digit timestamp, e.g. 20070114174502Use |certyear= and |certweek= for correct citation titles.Supports |domestic=true where relevant (albums before 2011 and singles from 2021) and for correct sales.Sales require relyear and sometimes relmonth . |
IFPI Greece#Certifications | Shipments |
Hong Kong | Albums only. Only up to 2008. | [8] | Sales |
Hungary | requires certyear Sales require relyear and sometimes relmonth and relday Set |domestic=true for domestic releases.Unknown sales thresholds for international albums released before 23 April 2002. |
[28][29][30][31][32][8][33][34][35][36] | Shipments→Sales+Streaming |
Ireland | requires certyear Certifications available only from 2005 to 2013 |
[9] | Shipments |
Italy | Use |id= for referencing the individual page (found at the end of the URL after clicking "Richiedi Targhetta"). Otherwise, manual search required.Sales require relyear and for singles may require certyear and certweek . May also use certmonth and relmonth for correct footnotes. |
[37][38][39][40][41][42][43][44][45][46][47][48] | Sales→Sales+Streaming |
Japan | Requires certyear and certmonth Set |digital=true for digital singles certifications.Set |streamsonly=true for streaming singles certifications.Supports |domestic=true for domestic repertoire prior to July 2003.Supports |type=ringtone for ringtone certification prior to March 2014.Automatic citation for albums and digital/streaming singles only |
[10] [11] [49][50] | Sales/Shipments/Streaming-only |
Mexico | Manual search required Sales require relyear and sometimes relmonth . May also use certyear and certmonth for correct footnotes.Supports |award=Platinum+Gold and |award=Diamond+Gold with |number2= being the number of Gold awards. Supports |award=Diamond+Platinum with |number2= being the number of Platinum awards. Supports and |award=Diamond+Platinum+Gold with |number2= being the number of Platinum awards and |number3= being the number of Gold awards.Supports |preloaded=true for pre-loaded album/track/video. Supports |type=ringtone |
[51][52][53] | Sales/Shipments→Sales+Streaming |
Netherlands | Manual search required Supports |type=jazz for jazz, classical and world music albums.Sales require relyear and sometimes relmonth . May also use certyear and certmonth for correct footnotes. |
[12] [13] [14] [15] | Shipments→Sales+Streaming |
New Zealand | type can be compilation Specifying |source=archive uses Radioscope certifications which go April 2007 to July 2011.Specifying |source=book uses Scapolo, Dean (2007). The Complete New Zealand Music Charts: 1966 – 2006. Wellington: Maurienne House. ISBN 978-1877443-00-8. and |id= is the page number.Specifying |source=newchart uses the new website at aotearoamusiccharts.co.nz which has charts from 1975. |id= is the date of the chart in the format YYYY-MM-DD, and |domestic=true is supported.Otherwise, or specifying |source=oldchart , uses the defunct nztop40.co.nz which had charts from 1975. |id= required, the chart number and |domestic=true is supported.Sale and footnotes require certyear and sometimes certmonth and certday |
[54][55][56][57][58] | Sales/Shipments→Sales+Streaming |
Nigeria | [59] | Streaming | |
Norway | Sales require relyear and sometimes relmonth Unknown sales thresholds for singles before July 2002. |
[16] [17] [18] [19] [20][21] [22] | Sales→Sales+Streaming |
Philippines | Sales require certyear and sometimes certmonth Supports |domestic=true |
Philippine Association of the Record Industry#Certification levels | Sales |
Poland | Requires|certyear= and |award= for correct citation.Manual search required if certyear>=2023 Supports |type=jazz and |domestic=true .Sales require |certyear= and sometimes |certmonth= , |relyear= and |relmonth= |
[60][61][62][63][64][65][66][67][68] | Sales→Sales+Streaming |
Portugal | Supports three citation modes:
Sales require |
[69][70][29][71][72][73] | Shipments→Sales+Streaming |
Russia | Supports |type=ringtone (without automatic citation) requires certyear Sales require relyear and sometimes relmonth supports |domestic=true Automatic citation for albums only |
[74][23][dead link] | Sales |
Singapore | Sales for albums require certyear Automatic citation for albums certified in 2019 only |
[3][8][39][75] | Sales |
South Africa | Sales may require relyear , certyear and relmonth . |
[8][76][77][78] | Sales→Sales+Streaming |
South Korea | Set |streamsonly=true for streaming singles certifications. |
[24] | Sales/Shipments/Streaming-only |
Spain | To use an El portal de Música specific title entry add |id= , the end of the url for that title. For example, for citing "Viva La Vida", the url is https://www.elportaldemusica.es/single/coldplay-viva-la-vida-2 and one needs to set |id=coldplay-viva-la-vida-2 .To use weekly tables, |certyear= is the year for the certification and |certweek= is the week number on which the PDF is available from the dropdown available under the week tab.To use the El portal de Música certification database, don't specify |certweek= or |id= . Sales require |relyear= and sometimes |relmonth= and |relday= For Digital Downloads certification set |digital=true . For Original Tones set |type=ringtone .Also supports |streamsonly=true for streaming certifications between 2013 week 46 and the end of 2014 |
Productores de Música de España#Certifications [25] |
Shipments/Streaming-only→Sales+Streaming |
Sweden | Use |certyear= and |certweek= To cite from a chart, where |position= can be used to ease navigation (use |source=chart to force this option). Use |source=artist to cite by |artist= . Otherwise, can use |certyear= for an archived citation but only until 2011.Sales may require relyear and sometimes relmonth . |
[26] [27][79][80] | Shipments→Sales+Streaming/Streaming-only |
Switzerland | Sales require relyear . May also use certyear for correct footnotes.Set |domestic=true for repertoire in French and Italian |
[28] | Shipments→Sales+Streaming |
Taiwan | Sales require certyear and sometimes certmonth Supports |domestic=true for local albumsSupports |award=Platinum+Gold |
[29] | Sales |
Turkey | requires certyear , only between 2004 and 2009. Prior to 2006 the only award is Diamond .Set |domestic=true for local artists |
[30] | Sales |
United Kingdom | Manual search required if id not specifiedSales for singles require relyear Set discount =true for correct discount album sales figure.For albums, sales correct only from 1979 |
[31] [32] | Shipments/Sales→Sales+Streaming |
United States | Supports multidisc for multi-disc packagesSupports |type=ringtone for mastertone certifications, |type=videosingle for video singles and |type=EP for "short form album".set |Spanish=true for Latin certifications. Correct Latin album sales require certyear and sometimes certmonth and certday Sales for singles require certyear Set |digital=true for digital single certification and mastertone |
[33] [34] [35] [36] [81] | Shipments/Sales→Sales+Streaming |
Uruguay | requires certyear |
[37] [29] [38] [8] | Shipments |
IFPI summary tables: IFPI June 2013,[13] IFPI March 2013,[82] IFPI August 2012,[33] IFPI July 2012,[83] IFPI March 2012,[84] IFPI September 2011,[71] IFPI March 2011,[85] IFPI September 2010,[40] IFPI December 2009,[39] IFPI 2009[9], IFPI 2008,[86] IFPI October 2007,[8] IFPI September 2007,[4] IFPI January 2007,[3] IFPI 2006,[31] RIAJ 2005.[29]
M&M certifications: 1987[27] 1986[87]
References
{{cite web}}
: CS1 maint: unfit URL (link)
The following categories should always be empty as they represent erroneous usage of the template.
The following categories are for tracking different forms of usage.
|nocat=
is set, these templates track the usage for different regionsTemplateData documentation used by VisualEditor and other tools
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
See a monthly parameter usage report for Template:Certification Table Entry in articles based on its TemplateData.
TemplateData for Certification Table Entry No description.
|