Template:Cite certification/doc

__EXPECTED_UNCONNECTED_PAGE__

Usage

This template creates a {{cite web}} citation for music sales certification data from different regions. The citation created is as accurate as possible using the parameters given. Remember to check the output (e.g., for red error messages, broken links) when using this template; as an editor it is your responsibility to check your additions.

The template is also used internally by {{Certification Table Entry}} as its source of citations.

Fields

• <syntaxhighlight lang="wikitext" inline style="display: none;" />|region= – region in which the certification was awarded
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|title= – title of work
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|artist= – performing artist or group
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|type= – <syntaxhighlight lang="text" class="" style="" inline="1">album</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">single</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">video</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">jazz</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">compilation</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">videosingle</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">ringtone</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">EP</syntaxhighlight> (see support below)
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|award= – <syntaxhighlight lang="text" class="" style="" inline="1">Diamond</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Platinum</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Gold</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Silver</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Million</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Billion</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Diamond+Platinum</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Diamond+Gold</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Platinum+Gold</syntaxhighlight>/<syntaxhighlight lang="text" class="" style="" inline="1">Diamond+Platinum+Gold</syntaxhighlight>

• <syntaxhighlight lang="wikitext" inline style="display: none;" />|access-date= – date on which the data was accessed for verification
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|date= – certification date
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|number= – number of awards given
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear= – year in which certification was awarded, used for linking in some cases
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|certmonth= – month in which certification was awarded, used for linking in some cases
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|certweek= – week in which certification was awarded, used for linking in some cases
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= – documented where relevant
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|position= – chart position of work at time of certification, can used in some cases to ease navigation
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|source= – determines the source of the certification, documented where relevant
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|digital= – set to <syntaxhighlight lang="text" class="" style="" inline="1">true</syntaxhighlight> for digital download certifications, see support below
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|streaming= – set to <syntaxhighlight lang="text" class="" style="" inline="1">true</syntaxhighlight> for streaming certifications, see support below
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|domestic= – set to <syntaxhighlight lang="text" class="" style="" inline="1">true</syntaxhighlight>, documented where relevant
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|Spanish= – set to <syntaxhighlight lang="text" class="" style="" inline="1">true</syntaxhighlight> for Spanish/Latin certifications, see support below
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|best= – specific usage, see support below
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|archiveurl= – specifies URL of archived info; used for old Portugal certifications only
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|archivedate= – specifies date info was archived; used for old Portugal certifications only
• <syntaxhighlight lang="wikitext" inline style="display: none;" />|ref= – creates an HTML anchor identifier. When set, <syntaxhighlight lang="wikitext" inline style="display: none;" />|ref=ID generates an anchor with the given ID (the id= attribute in the citation's <cite id="ID"> HTML tag). Setting <syntaxhighlight lang="wikitext" inline style="display: none;" />|ref=ID identifies the template as a target and allows wikilinking to full references, especially useful with short-form citations like shortened notes.

Usage examples

• To list all Linkin Park titles winning certification in Germany

<syntaxhighlight lang="wikitext"> "Gold-/Platin-Datenbank (Linkin Park)" (in German). Bundesverband Musikindustrie.{{cite web}}: CS1 maint: unrecognized language (link) </syntaxhighlight>

produces

"Gold-/Platin-Datenbank (Linkin Park)" (in German). Bundesverband Musikindustrie.{{cite web}}: CS1 maint: unrecognized language (link)

• To list certifications in the United States for Coldplay's A Rush of Blood to the Head (also using access-date)

<syntaxhighlight lang="wikitext"> "American certifications – Coldplay – A Rush of Blood to the Head". Recording Industry Association of America. Retrieved 2010-10-29. </syntaxhighlight>

produces

"American certifications – Coldplay – A Rush of Blood to the Head". Recording Industry Association of America. Retrieved 2010-10-29.

• To list Australian certifications for U2's album Achtung Baby, note that although the album was released in 1991 the last certification (to date) was in 1998

<syntaxhighlight lang="wikitext"> "ARIA Charts – Accreditations – 1998 Albums" (PDF). Australian Recording Industry Association. </syntaxhighlight>

produces

"ARIA Charts – Accreditations – 1998 Albums" (PDF). Australian Recording Industry Association.

Supported regions

Regions supported by template, with relevant parameters

Region	Fields	Notes
Argentina	title artist type=album/video	Information for old singles and compilation albums as well as new digital downloads is unavailable
Australia	certyear type=album/single/video source id	Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear= to cite the yearly archives from 1990 to 2022 To cite ARIA Top 50 charts (from July 2019), set <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= to YYYY-MM-DD, e.g. <syntaxhighlight lang="wikitext" inline style="display: none;" />|id=2019-07-22. To cite the Australian artist Top 20, set <syntaxhighlight lang="wikitext" inline style="display: none;" />|domestic=true To cite ARIA Top 50 yearly charts (from 1988) set <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=yearchart Can also set <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=book to use Ryan, Gavin (2011). Australia's Music Charts 1988–2010 (PDF ed.). Mt Martha, Victoria, Australia: Moonlight Publishing. and <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= is the page number.
Austria	title artist type
Belgium	certyear type	Certifications for albums and singles are available separately. Use <syntaxhighlight lang="text" class="" style="" inline="1">type</syntaxhighlight> for a correct citation.
Brazil	artist type
Canada	title artist type certmonth certyear digital	certmonth and certyear are only used as backward compatibility if both title and artist are not supplied, in which case the old database is used (only valid from 2001) Set <syntaxhighlight lang="wikitext" inline style="display: none;" />|digital=true for digital downloads or <syntaxhighlight lang="wikitext" inline style="display: none;" />|type=ringtone for ringtones
Central America
Denmark	certyear source id type	Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=chart to use weekly charts, which is required before 2004. <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear= is the chart year and <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= is the chart week. Otherwise, if <syntaxhighlight lang="text" class="" style="" inline="1">id</syntaxhighlight> is specified, will use the node number (accessible from the URL after search). Otherwise will use the default location http://www.ifpi.dk/certificeringer-0
Europe	certyear	Albums only. Only up to 2014.
Finland	artist domestic	Will use domestic certifications if <syntaxhighlight lang="wikitext" inline style="display: none;" />|domestic=true
France	artist title type=album/single/video/compilation source certyear award number	Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=archive to use SNEP archives as source, requires <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear=, <syntaxhighlight lang="wikitext" inline style="display: none;" />|award= and <syntaxhighlight lang="wikitext" inline style="display: none;" />|number= for multiple awards. Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=infodisc for unofficial www.infodisc.fr tables (Manual search required)
GCC	certyear	From 2009 to 2011 only.
Germany	title artist type=album/single/video best=yes*/no	In cases where the best certification does not show up (known bug), set <syntaxhighlight lang="wikitext" inline style="display: none;" />|best=no to show the entire certification history
Greece	id type certyear certweek domestic	Referenced from Wayback Machine archive, e.g. here. id is the full 14 digit timestamp, e.g. 20070114174502. Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear= and <syntaxhighlight lang="wikitext" inline style="display: none;" />|certweek= for correct titles. Supports <syntaxhighlight lang="wikitext" inline style="display: none;" />|domestic=true where relevant (albums before 2011 and singles from 2021)
Hong Kong	certyear	Albums only. Only up to 2008.
Hungary	certyear
Ireland	award number certyear	From 2005 to 2013 only.
Italy	id title artist	From 2009 only. Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= for referencing the individual page (found at the end of the URL after clicking "Richiedi Targhetta"). Otherwise, can use <syntaxhighlight lang="wikitext" inline style="display: none;" />|title= or <syntaxhighlight lang="wikitext" inline style="display: none;" />|artist=.
Japan	certmonth certyear digital streaming type	Set <syntaxhighlight lang="wikitext" inline style="display: none;" />|digital=true or <syntaxhighlight lang="wikitext" inline style="display: none;" />|type=ringtone for digital download certifications Set <syntaxhighlight lang="wikitext" inline style="display: none;" />|streaming=true uses the streaming certifications
Mexico	artist title type	Manual search required
Netherlands	artist type	Manual search required
New Zealand	type=album/single/compilation id source domestic archive-url archive-date	Supports five sources: If <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=archive, uses Radioscope certifications archive which only go April 2007 to July 2011. If <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=book, uses Scapolo, Dean (2007). The Complete New Zealand Music Charts: 1966 – 2006. Wellington: Maurienne House. ISBN 978-1877443-00-8. and <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= is the page number. If <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=radioscope, uses the 2024 RadioScope certification search which has certifications since 2013. This option requires manual search. If <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=newchart, uses the new website at aotearoamusiccharts.co.nz which has charts from 1975. In this case <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= is the date of the chart in the format YYYY-MM-DD. Setting <syntaxhighlight lang="wikitext" inline style="display: none;" />|domestic=true will use the domestic charts. Otherwise, or if <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=oldchart, uses the defunct website at nztop40.co.nz which had charts from 1975. In this case <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= is the number of the chart and setting <syntaxhighlight lang="wikitext" inline style="display: none;" />|domestic=true will use the domestic charts. This option also requires setting <syntaxhighlight lang="wikitext" inline style="display: none;" />|archive-url= and <syntaxhighlight lang="wikitext" inline style="display: none;" />|archive-date=.
Nigeria		From 2023
Norway	artist certyear
Philippines
Poland	type=album/single/video/jazz award certyear	Uses ZPAV source with annual certlists if <syntaxhighlight lang="text" class="" style="" inline="1">1995<=certyear<=2023</syntaxhighlight>, where <syntaxhighlight lang="text" class="" style="" inline="1">award</syntaxhighlight> is mandatory to identify the section (Gold, Platinum and Diamond). Otherwise, can be used OLiS source, which requires manual search.
Portugal	certyear id source archiveurl archivedate	Supports three sources. The first is working and the latter two are obsolete and used only for backward compatibility: audiogest: Used if <syntaxhighlight lang="text" class="" style="" inline="1">certyear>=2018</syntaxhighlight>. Requires <syntaxhighlight lang="wikitext" inline style="display: none;" />|id=FILENAME, where filename is according to the stored URL <syntaxhighlight lang="text" class="" style="" inline="1">http://www.audiogest.pt/uploads/files/FILENAME</syntaxhighlight>. Obsolete 1 afp: Used if <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=archive. Works correctly only for <syntaxhighlight lang="text" class="" style="" inline="1">2007<=certyear<=2010</syntaxhighlight>. Uses an archived version. Obsolete 2 artistas-espectaculos: Used in all other cases. Requires <syntaxhighlight lang="wikitext" inline style="display: none;" />|id=XXXXYY where XXXX is the year and YY is the week in which the title charted. Requires <syntaxhighlight lang="wikitext" inline style="display: none;" />|archiveurl= and <syntaxhighlight lang="wikitext" inline style="display: none;" />|archivedate=, but will provide a helper link if they are not supplied. Works correctly only for <syntaxhighlight lang="text" class="" style="" inline="1">2004<=certyear<=2010</syntaxhighlight>.
Russia	certyear	Albums only
Singapore		Albums only. From 2019 to 2021 only
South Africa	artist title
South Korea	type streaming	From April 2018 only
Spain	certyear certweek id type streaming digital artist title	If <syntaxhighlight lang="wikitext" inline style="display: none;" />|id= is set, will use the El portal de Música entry to reach the specific title. In this case, <syntaxhighlight lang="text" class="" style="" inline="1">id</syntaxhighlight> should be set to the end of the url for that title, e.g. for citing "Viva La Vida", the url is https://www.elportaldemusica.es/single/coldplay-viva-la-vida-2 and one needs to set <syntaxhighlight lang="wikitext" inline style="display: none;" />|id=coldplay-viva-la-vida-2. Also <syntaxhighlight lang="wikitext" inline style="display: none;" />|type= is mandatory in this case. Otherwise, if <syntaxhighlight lang="wikitext" inline style="display: none;" />|certweek= is used, <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear= is the year for the certification and <syntaxhighlight lang="wikitext" inline style="display: none;" />|certweek= is the week number on which the PDF is available from the dropdown available under the week tab. This option supports <syntaxhighlight lang="wikitext" inline style="display: none;" />|streaming=true, <syntaxhighlight lang="wikitext" inline style="display: none;" />|digital=true and <syntaxhighlight lang="wikitext" inline style="display: none;" />|type=ringtone, relevant only for 2008 certifications. Otherwise, <syntaxhighlight lang="wikitext" inline style="display: none;" />|artist= and/or <syntaxhighlight lang="wikitext" inline style="display: none;" />|title= are used to search the El portal de Música certification database.
Sweden	certyear certweek position type=single/album artist source	Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=artist to cite by <syntaxhighlight lang="wikitext" inline style="display: none;" />|artist=. Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=chart to cite by <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear= and <syntaxhighlight lang="wikitext" inline style="display: none;" />|certweek= from a chart, where <syntaxhighlight lang="wikitext" inline style="display: none;" />|position= can be used to ease navigation. Use <syntaxhighlight lang="wikitext" inline style="display: none;" />|source=grammotex to cite from the grammotex website by <syntaxhighlight lang="wikitext" inline style="display: none;" />|id=. Otherwise, can use <syntaxhighlight lang="wikitext" inline style="display: none;" />|certyear= for an archived citation but only until 2011.
Switzerland	artist title certyear	Will use title if available, artist as a second option, and certyear as last option.
Taiwan
Turkey	certyear	From 2004 to 2009 only
United Kingdom	artist title id type	Manual search required
United States	title artist type=album/single/video/videosingle/ringtone/EP Spanish	Set <syntaxhighlight lang="wikitext" inline style="display: none;" />|Spanish=true for Latin certifications
Uruguay	certyear

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Cite certification in articles based on its TemplateData.

TemplateData for Cite certification

<templatedata> { "params": { "region": { "required": true }, "title": { "required": true }, "artist": { "required": true }, "type": { "required": true, "suggestedvalues": [ "album", "single", "video", "jazz", "compilation", "videosingle", "ringtone", "EP" ] }, "access-date": { "aliases": [ "accessdate" ] }, "date": {}, "source": {}, "id": {}, "certyear": {}, "domestic": {}, "certmonth": {}, "digital": { "type": "boolean", "autovalue": "true" }, "award": { "suggestedvalues": [ "Diamond", "Platinum", "Gold", "Silver", "Million", "Billion", "Diamond+Platinum", "Diamond+Gold", "Platinum+Gold", "Diamond+Platinum+Gold" ] }, "number": {}, "best": {}, "certweek": {}, "streaming": { "type": "boolean", "autovalue": "true" }, "archive-url": { "aliases": [ "archiveurl" ] }, "archive-date": { "aliases": [ "archivedate" ] }, "position": {}, "Spanish": { "type": "boolean", "autovalue": "true" }, "ref": { "description": "HTML anchor for linking to the citation" } }, "paramOrder": [ "region", "title", "artist", "type", "award", "access-date", "date", "number", "certyear", "certmonth", "certweek", "id", "position", "source", "digital", "streaming", "Spanish", "domestic", "best", "archive-url", "archive-date", "ref" ], "format": "inline" } </templatedata>

Tracking categories

• Category:Pages using cite certification with unknown parameters (0)
• Category:Cite certification used with missing parameters (0)