ഫലകം:Certification Table Entry

ഫലകത്തിന്റെ വിവരണം

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	5,00,000*
Germany (BVMI)	2× Platinum	10,00,000^
United States (RIAA)	2× Platinum	20,00,000‡
Streaming
Sweden (GLF)	Platinum	80,00,000†
Summaries
Europe (IFPI)	4× Platinum	40,00,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

• artist – performing artist or group
• title – title of work
• award – Silver/Gold/Platinum/Diamond/Million/Billion. Not all types supported for all regions. Please only use awards you see used by the awarding authority
• type – album/single/video/jazz. 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 – set to any value if no sales figure is to be displayed
• nocert – set to any value 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.
• 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
• 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
• recent – true for recent certification, see below
• 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 certificatoin, 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	Specify |id=YYYY-MM-DD to use the ARIA charts, archived since July 2019. Can also use |domestic=true for Australian artist charts For older certifications, use certyear for an archived list. For even older certifications, specifying |recent=book uses 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.	[2]	Sales→Sales+Streaming
Belgium	requires certyear supports |domestic=true Sales require certyear and relyear and sometimes relmonth and certmonth. Unknown thresholds for albums between 2006 and March 2007.	[3] [4] [5] [6] [7] [8] [9]	Sales→Sales+Streaming
Brazil	Sales require certyear Set |domestic=true for domestic certification. Set |digital=true for album digital certification.	Pro-Música Brasil#Sales certification	Sales→Sales+Streaming
Canada	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	Music Canada#Certification awards	Sales/Shipments→Sales+Streaming
Denmark	Specifying |recent=false 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	[10] [11] [12] [13] [14] [15]	Shipments/Streaming-only→Sales+Streaming
Europe	requires certyear Albums only Use only in the summary section	[16]	Sales
Finland	Requires |artist= Requires |salesamount= from reported source Supports |domestic=true for local artists	Not used
France	requires certyear type also can be compilation Sales require certyear and may require certmonth and certday for some release dates set |recent=false for certification dates before 1994	[17] [18] [19] [20]	Sales→Sales+Streaming
GCC	requires certyear. Supports |domestic=true, but without automatic citation.	[21]	Sales
Germany	type also can be jazz Sales require relyear and sometimes relmonth and relday. 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	[22]	Shipments→Sales+Streaming
Greece	Referenced from wayback machine archive here require id, the full 14 digit timestamp, e.g. 20070114174502 Sales require relyear and sometimes relmonth. Supports domestic certifications.	[23] [24] [25] [26] [27]	Shipments
Hong Kong		[28]	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 or between 23 February 2005 and 12 September 2006.	[29] [30]	Shipments→Sales+Streaming
Ireland	requires certyear Certifications availble only from 2005 to 2013	?	Shipments
Italy	Manual search required Sales require relyear and for singles may require certyear and certweek. May also use certmonth and relmonth for correct footnotes.	[31] [32] [33] [34]	Sales→Sales+Streaming
Japan	Requires certyear and certmonth Sales require relyear and sometimes relmonth Set |digital=true for digital singles certifications. Set |streamsonly=true for streaming singles certifications. Supports |domestic=true for domestic repertoire prior to July 2003. Automatic citation for albums and digital/streaming singles only	[35] [36][37]	Sales/Shipments/Streaming-only
Mexico	Sales require relyear and sometimes relmonth. May also use certyear and certmonth for correct footnotes. Supports |award=Platinum+Gold,|award=Diamond+Gold,|award=Platinum+Diamond and even |award=Platinum+Diamond+Gold with |number= being the number of Platinum awards. Does not support multiple Diamond and Platinum awards together.	[38]	Sales/Shipments→Sales+Streaming
Netherlands	Manual search required Sales require relyear and sometimes relmonth. May also use certyear and certmonth for correct footnotes.	[39] [40] [41] [42]	Shipments→Sales+Streaming
New Zealand	type also can be compilation Specifying |recent=false uses Radioscope certifications which go April 2007 to July 2011. Specifying |recent=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. Sales require relyear and sometimes relmonth and relday. May also use certyear, certmonth and certday for correct footnote.	[43] [44]	Sales/Shipments→Sales+Streaming
Norway	Sales require relyear and sometimes relmonth Unknown sales thresholds for singles before July 2002.	[45] [46] [47] [48] [49][50] [51]	Sales→Sales+Streaming
Philippines	Sales require certyear and sometimes certmonth Supports |domestic=true	Philippine Association of the Record Industry#Certification levels	Sales
Poland	Sales require relyear and sometimes relmonth. May also use certyear and certmonth for correct footnotes. Requires certyear Supports |domestic=true	[52] [53]	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 |recent=true. 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.	[54] [55] [56] [57]	Shipments→Sales+Streaming
Russia	requires certyear Sales require relyear and sometimes relmonth supports para Automatic citation for albums only	[58]	Sales
Singapore	Sales for albums require certyear Automatic citation for albums certified in 2019 only	Recording Industry Association Singapore#Sales certificates	Sales
South Korea	Set |streamsonly=true for streaming singles certifications.	[59]	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	Shipments/Streaming-only→Sales+Streaming
Sweden	requires certyear along with certweek for certifications after 2011. position can be used to ease navigation. Sales may require relyear and sometimes relmonth.	[60] [61], https://www.ifpi.se/musikbolag/guld-och-platina/	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	[62]	Shipments→Sales+Streaming
Taiwan	Sales require certyear and sometimes certmonth Supports |domestic=true for local albums	[63]	Sales
Turkey	requires certyear, only between 2004 and 2009. Prior to 2006 the only award is Diamond. Set |domestic=true for local artists	[64]	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	[65] [66]	Shipments/Sales→Sales+Streaming
United States	Supports multidisc for multi-disc packages set |Spanish=true for Spanish certification. Correct Spanish album sales require certyear and sometimes certmonth and certday Sales for singles require certyear Set |digital=true for digital single certification	[67] [68] [69] [70]	Shipments/Sales→Sales+Streaming
Uruguay	requires certyear	[71] [72] [73] [74]	Shipments

IFPI summary tables: June 2013 September 2011 September 2010, January 2009, October 2007, 2005/2006

Tracking categories

Error categories

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

• Category:Pages using certification Table Entry with unknown parameters (1)
• 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 (7) (indirectly, through calling {{cite certification}})
• Category:Certification Table Entry usages of salesamount without salesref (1) (not nearly empty)

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 (2)
• Category:Pages using certification Table Entry without sales (1)
• Category:Certification Table Entry usages for unsupported region (1)
• Category:Pages using certification Table Entry with sales figures (3) (cf. Category:Pages using certification Table Entry with sales footnote (1))
• Category:Pages using certification Table Entry with shipments figures (2) (cf. Category:Pages using certification Table Entry with shipments footnote (4))
• Category:Pages using certification Table Entry with streaming figures (3) (cf. Category:Pages using certification Table Entry with streaming footnote (3))
• 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}}