Template:Certification Table Entry/doc

Specific parameters

Mandatory

• |artist= – performing artist or group
• |title= – title of work
• |award= – Silver/Gold/Platinum/Diamond/Million/Billion/Platinum+Gold/Diamond+Gold/Diamond+Platinum/Diamond+Platinum+Gold/Bronze. Awards vary by region. See other supported awards for specific regions below.
• |type= – album/single/video/jazz/compilation/videosingle/ringtone. Not all types supported for all regions, see table below for details

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 Template:Xtag.
• |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
• |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
• |position= – chart position of work when certification was awarded, used for easing navigation 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.
• |discount= – true for discount albums, influences certification levels in some regions
• |domestic= – true for domestic titles, influences certification levels and citation in some regions
• |multidisc= – the number of discs in a multi-disc package
• |source= – determines the source of the certification, documented where relevant
• |Spanish= – true for Spanish-speaking albums, see United States below
• |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
• |note= – Additional notes, e.g. specific edition certified
• |best= – see Germany below
• |refname= – enables you to specify a name for the reference generated by the template
• |footnote= – Overrides the footnote symbol. Allowed values are sales/shipments/streaming/streamsonly

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 Template:Cite Ryan and |id= is the page number. Correct sales requires |certyear=. Correct footnotes may require |certmonth=.	[1]	ShipmentsTemplate:Right arrowSales+Streaming
Austria	Sales require relyear and sometimes relmonth.	[2]	SalesTemplate:Right arrowSales+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.		SalesTemplate:Right arrowSales+Streaming
Brazil	Sales require certyear Set |domestic=true for domestic certification. Set |digital=true for album digital certification.		SalesTemplate:Right arrowSales+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/ShipmentsTemplate:Right arrowSales+Streaming
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	[3] [4] [5] [6] [7] [8]	Shipments/Streaming-onlyTemplate:Right arrowSales+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		SalesTemplate:Right arrowSales+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		ShipmentsTemplate:Right arrowSales+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.	[9]	Sales
Hungary	requires certyear Sales require relyear and sometimes relmonth and relday Set |domestic=true for domestic releases. Unknown sales thresholds for international albums before 23 April 2002.		ShipmentsTemplate:Right arrowSales+Streaming
Ireland	requires certyear Certifications availble only from 2005 to 2013	[10]	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.	[11] [12] [13] [14]	SalesTemplate:Right arrowSales+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	[15] [16]	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, |award=Diamond+Gold. Supports |award=Diamond+Platinum and |award=Diamond+Platinum+Gold with |number2= being the number of Platinum awards. Supports |preloaded=true for pre-loaded album/track/video. Supports |type=ringtone		Sales/ShipmentsTemplate:Right arrowSales+Streaming
Netherlands	Manual search required Sales require relyear and sometimes relmonth. May also use certyear and certmonth for correct footnotes.	[17] [18] [19] [20]	ShipmentsTemplate:Right arrowSales+Streaming
New Zealand	type also can be compilation Specifying |source=archive uses Radioscope certifications which go April 2007 to July 2011. Specifying |source=book uses Template:Cite Scapolo 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. Sales require relyear and sometimes relmonth and relday. May also use certyear, certmonth and certday for correct footnote.	[21] [22]	Sales/ShipmentsTemplate:Right arrowSales+Streaming
Norway	Sales require relyear and sometimes relmonth Unknown sales thresholds for singles before July 2002.	[23] [24] [25] [26] [27][28] [29]	SalesTemplate:Right arrowSales+Streaming
Philippines	Sales require certyear and sometimes certmonth Supports |domestic=true	Philippine Association of the Record Industry#Certification levels	Sales
Poland	Supports |type=jazz. Sales require certyear and sometimes certmonth, relyear and relmonth. Uses certyear and certmonth for correct footnotes. Supports |domestic=true		SalesTemplate:Right arrowSales+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 |archiveurl= and |archivedate= Sales require relyear and may require relmonth and relday. May also use certyear for correct footnotes.	[30] [31]	ShipmentsTemplate:Right arrowSales+Streaming
Russia	Supports |type=ringtone (without automatic citation) requires certyear Sales require relyear and sometimes relmonth supports |domestic=true Automatic citation for albums only	[32]	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.		SalesTemplate:Right arrowSales+Streaming
South Korea	Set |streamsonly=true for streaming singles certifications.	[33]	Sales/Shipments/Streaming-only
Spain	To use El portal de Música 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. Sales require |relyear= and sometimes |relmonth= and |relday= For Original Tones and Digital Downloads certification set |digital=true Also supports |streamsonly=true for streaming certifications between 2013 week 46 and the end of 2014	Productores de Música de España#Certifications [34]	Shipments/Streaming-onlyTemplate:Right arrowSales+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.	[35] [36], [37]	ShipmentsTemplate:Right arrowSales+Streaming/Streaming-only
Switzerland	Sales require relyear. May also use certyear for correct footnotes. Set |domestic=true for repertoire in French and Italian	[38]	ShipmentsTemplate:Right arrowSales+Streaming
Taiwan	Sales require certyear and sometimes certmonth Supports |domestic=true for local albums Supports |award=Platinum+Gold	[39]	Sales
Turkey	requires certyear, only between 2004 and 2009. Prior to 2006 the only award is Diamond. Set |domestic=true for local artists	[40]	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	[41] [42]	Shipments/SalesTemplate:Right arrowSales+Streaming
United States	Supports multidisc for multi-disc packages Supports |type=ringtone for mastertone certifications type also can be videosingle 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	[43] [44] [45] [46]	Shipments/SalesTemplate:Right arrowSales+Streaming
Uruguay	requires certyear	[47] [48]	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 Template:Reftalk

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 (5) (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 (0): Unless |nocat= is set, these templates track the usage for different regions
• Category:Pages using certification Table Entry without certification (0)
• Category:Pages using certification Table Entry without sales (0)
• Category:Certification Table Entry usages for unsupported region (0)
• Category:Pages using certification Table Entry with sales figures (0) (cf. Category:Pages using certification Table Entry with sales footnote (0))
• Category:Pages using certification Table Entry with shipments figures (0) (cf. Category:Pages using certification Table Entry with shipments footnote (0))
• Category:Pages using certification Table Entry with streaming figures (0) (cf. Category:Pages using certification Table Entry with streaming footnote (0))
• Category:Pages using certification Table Entry with streaming-only figures (0) (cf. Category:Pages using certification Table Entry with streaming-only footnote (0))

See also

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