Template:Certification Table Entry/doc

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.

• {{Certification Table Top}} for the top of the table;
• {{Certification Table Entry}} for table entries;
• {{Certification Table Separator}} for creating a separator, e.g. for starting the summary section (can also use {{Certification Table Summary}});
• {{Certification Table Bottom}} for the bottom of the table.

See each of the templates for specific documentation. The template also uses {{cite certification}} for citation, see documentation there.

Common parameters

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.

Usage example

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:

Certifications for "Best song Ever"

Region	Certification	Certified units/sales
Finland (Musiikkituottajat)	Gold	32,682
France (SNEP)	Platinum	500,000*
Germany (BVMI)	2× Platinum	1,000,000^
United States (RIAA)	2× Platinum	2,000,000‡
Streaming
Sweden (GLF)	Platinum	8,000,000†
Summaries
Europe (IFPI)	4× Platinum	4,000,000*
* Sales figures based on certification alone. ^ Shipments figures based on certification alone. ‡ Sales+streaming figures based on certification alone. † Streaming-only figures based on certification alone.

Specific parameters

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 categorization

Supported regions

Regional parameters for the template

Region	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 2021 To 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.		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.		Sales→Sales+Streaming
Brazil	Sales require relyear and sometimes relmonth Set |domestic=true for domestic certification. Set |digital=true for album digital certification.		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		Sales/Shipments→Sales+Streaming
Central America			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		Sales
Finland	Requires |artist= Requires |salesamount= from reported source Supports |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		Sales→Sales+Streaming
GCC	requires certyear. Supports |domestic=true, but without automatic citation.		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		Shipments→Sales+Streaming
Greece	Referenced from wayback machine archive here require id, the full 14 digit timestamp, e.g. 20070114174502 Use |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.		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.		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]	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		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. Otherwise, uses nztop40.co.nz which has charts from 1975. |id= required, the chart number and |domestic=true is supported. Sale and footnotes require certyear and sometimes certmonth and certday		Sales/Shipments→Sales+Streaming
Nigeria			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=		Sales→Sales+Streaming
Portugal	Supports three citation modes: For new certification (certyear>=2018) Requires |id=FILENAME, where FILENAME is according to the stored URL http://www.audiogest.pt/uploads/files/FILENAME. For older annual lists, 2007<=certyear<=2010, set |source=archive. From older archived weekly charts, for 2003<=certyear<=2010, requires |id=XXXXYY where XXXX is the year and YY is the week in which the title charted and requires |archive-url= and |archive-date= Sales require relyear and may require relmonth and relday. May also use certyear for correct footnotes.		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	[23]	Sales
Singapore	Sales for albums require certyear Automatic citation for albums certified in 2019 only		Sales
South Africa	Sales may require relyear, certyear and relmonth.		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]	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 albums Supports |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 specified Sales 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 packages Supports |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]	Shipments/Sales→Sales+Streaming
Uruguay	requires certyear	[37] [38]	Shipments

Sources

IFPI summary tables: IFPI June 2013, IFPI March 2013, IFPI August 2012, IFPI July 2012, IFPI March 2012, IFPI September 2011, IFPI March 2011, IFPI September 2010, IFPI December 2009, IFPI 2009, IFPI 2008, IFPI October 2007, IFPI September 2007, IFPI January 2007, IFPI 2006, RIAJ 2005.

M&M certifications: 1987 1986

References

Tracking categories

Error categories

The following categories should always be empty as they represent erroneous usage of the template.

• Category:Pages using certification Table Entry with unknown parameters (0)
• Category:Pages using Certification Table Entry-Sales with missing information (0)
• Category:Certification Table Entry usages for unsupported region without source (0)
• Category:Cite certification used with missing parameters (0) (indirectly, through calling {{cite certification}})
• Category:Certification Table Entry usages of salesamount without salesref (0)
• Category:Pages using Certification Table Entry with unsupported award (0)
• Category:Pages using Certification Table Entry with unsupported type (0)

Tracking categories

The following categories are for tracking different forms of usage.

• Category:Certification Table Entry usages (55): Unless |nocat= is set, these templates track the usage for different regions
• Category:Pages using certification Table Entry without certification (2,743)
• Category:Pages using certification Table Entry without sales (500)
• Category:Certification Table Entry usages for unsupported region (1,601)
• Category:Pages using certification Table Entry with sales figures (7,415) (cf. Category:Pages using certification Table Entry with sales footnote (7,414))
• Category:Pages using certification Table Entry with shipments figures (16,197) (cf. Category:Pages using certification Table Entry with shipments footnote (16,196))
• Category:Pages using certification Table Entry with streaming figures (17,730) (cf. Category:Pages using certification Table Entry with streaming footnote (17,730))
• Category:Pages using certification Table Entry with streaming-only figures (1,346) (cf. Category:Pages using certification Table Entry with streaming-only footnote (1,346))

See also

• {{Certification}}
• {{Cite certification}}

TemplateData

TemplateData 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. Template parameters This template prefers inline formatting of parameters. Parameter Description Type Status region region no description Unknown required title title no description Unknown required artist artist no description Unknown required type type no description Suggested values album single video jazz compilation videosingle ringtone EP Unknown required award award no description Suggested values Diamond Platinum Gold Silver Million Billion Diamond+Platinum Diamond+Gold Platinum+Gold Diamond+Platinum+Gold Unknown required format format no description Unknown optional access-date access-date accessdate no description Unknown optional date date no description Unknown optional nosales nosales no description Suggested values true Unknown optional nocert nocert no description Suggested values true Unknown optional certref certref no description Unknown optional number number no description Unknown optional number2 number2 no description Unknown optional number3 number3 no description Unknown optional relyear relyear no description Unknown optional relmonth relmonth no description Unknown optional relday relday no description Unknown optional certyear certyear no description Unknown optional certmonth certmonth no description Unknown optional certweek certweek no description Unknown optional certday certday no description Unknown optional salesamount salesamount no description Unknown optional salesref salesref no description Unknown optional id id no description Unknown optional position position no description Unknown optional multidisc multidisc no description Unknown optional source source no description Unknown optional digital digital no description Suggested values true Unknown optional streamsonly streamsonly no description Suggested values true Unknown optional preloaded preloaded no description Suggested values true Unknown optional domestic domestic no description Suggested values true Unknown optional Spanish Spanish no description Suggested values true Unknown optional discount discount no description Suggested values true Unknown optional note note no description Unknown optional best best no description Unknown optional refname refname no description Unknown optional footnote footnote no description Unknown optional archive-url archive-url archiveurl no description Unknown optional archive-date archive-date archivedate no description Unknown optional nocat nocat no description Unknown optional