Deleatur yhe: 1 revision imported

2026-09-11T06:48:23Z

1 revision imported

← Older revision	Revision as of 06:48, 11 September 2026
(No difference)

wikipedia>LuanCampSouza93 at 12:16, 24 August 2026

2026-08-24T12:16:28Z

New page

{{Documentation subpage}}
{{High-use}}
{{Lua|Module:Check for unknown parameters}}

== Usage ==
This template creates a {{tl|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 {{tl|Certification Table Entry}} as its source of citations.

== Fields ==
* {{para|region}} – region in which the certification was awarded
* {{para|title}} – title of work
* {{para|artist}} – performing artist or group
* {{para|type}} – {{code|album}}/{{code|single}}/{{code|video}}/{{code|jazz}}/{{code|compilation}}/{{code|videosingle}}/{{code|ringtone}}/{{code|EP}} (see support below)
* {{para|award}} – {{code|Diamond}}/{{code|Platinum}}/{{code|Gold}}/{{code|Silver}}/{{code|Million}}/{{code|Billion}}/{{code|Diamond+Platinum}}/{{code|Diamond+Gold}}/{{code|Platinum+Gold}}/{{code|Diamond+Platinum+Gold}}

* {{para|access-date}} – date on which the data was accessed for verification
* {{para|date}} – certification date
* {{para|number}} – number of awards given
* {{para|certyear}} – year in which certification was awarded, used for linking in some cases
* {{para|certmonth}} – month in which certification was awarded, used for linking in some cases
* {{para|certweek}} – week in which certification was awarded, used for linking in some cases
* {{para|id}} – documented where relevant
* {{para|position}} – chart position of work at time of certification, can used in some cases to ease navigation
* {{para|source}} – determines the source of the certification, documented where relevant
* {{para|digital}} – set to {{code|true}} for digital download certifications, see support below
* {{para|streaming}} – set to {{code|true}} for streaming certifications, see support below
* {{para|domestic}} – set to {{code|true}}, documented where relevant
* {{para|Spanish}} – set to {{code|true}} for Spanish/Latin certifications, see support below
* {{para|best}} – specific usage, see support below
* {{para|archiveurl}} – specifies URL of archived info; used for old Portugal certifications only
* {{para|archivedate}} – specifies date info was archived; used for old Portugal certifications only
* {{para|ref}} – creates an HTML anchor identifier. When set, {{para|ref|{{var|ID}}}} generates an anchor with the given <code>{{var|ID}}</code> (the <code>id=</code> attribute in the citation's {{tag|cite|params=id="{{var|ID}}"|o}} HTML tag). Setting {{para|ref|{{var|ID}}}} identifies the template as a target and allows [[Wikipedia:Citing sources/Further considerations#Wikilinks to full references|wikilinking to full references]], especially useful with short-form citations like [[Wikipedia:Citing sources#Shortened footnotes|shortened notes]].

== Usage examples ==
* To list all [[Linkin Park]] titles winning certification in Germany

<syntaxhighlight lang="wikitext">
{{Cite certification|region=Germany|artist=Linkin Park}}
</syntaxhighlight>

produces

{{Cite certification|region=Germany|artist=Linkin Park}}

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

<syntaxhighlight lang="wikitext">
{{Cite certification|region=United States|artist=Coldplay|title=A Rush of Blood to the Head|access-date=2010-10-29}}
</syntaxhighlight>

produces

{{Cite certification|region=United States|artist=Coldplay|title=A Rush of Blood to the Head|access-date=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">
{{Cite certification|region=Australia|type=album|certyear=1998}}
</syntaxhighlight>

produces

{{Cite certification|region=Australia|type=album|certyear=1998}}

== Supported regions ==
{| class="wikitable"
|+ Regions supported by template, with relevant parameters
!scope="col"| Region
!scope="col"| Fields
!scope="col"| Notes
|-
!scope="row"| Argentina
| title artist type=album/video || Information for old singles and compilation albums as well as new digital downloads is unavailable
|-
!scope="row"| Australia
| certyear type=album/single/video source id || Use {{para|certyear}} to cite the yearly archives from 1990 to 2022 To cite ARIA Top 50 charts (from July 2019), set {{para|id}} to YYYY-MM-DD, e.g. {{para|id|2019-07-22}}. To cite the Australian artist Top 20, set {{para|domestic|true}} To cite ARIA Top 50 yearly charts (from 1988) set {{para|source|yearchart}} Can also set {{para|source|book}} to use {{cite Ryan}} and {{para|id}} is the page number.
|-
!scope="row"| Austria
| title artist type ||
|-
!scope="row"| Belgium
| certyear type || Certifications for albums and singles are available separately. Use {{code|type}} for a correct citation.
|-
!scope="row"| Brazil
| artist type ||
|-
!scope="row"| Canada
| title artist type certmonth certyear digital || <code>certmonth</code> and <code>certyear</code> are only used as backward compatibility if both <code>title</code> and <code>artist</code> are not supplied, in which case the old database is used (only valid from 2001) Set {{para|digital|true}} for digital downloads or {{para|type|ringtone}} for ringtones
|-
!scope="row"| Central America
| ||
|-
!scope="row"| Denmark
| certyear source id type || Use {{para|source|chart}} to use weekly charts, which is required before 2004. {{para|certyear}} is the chart year and {{para|id}} is the chart week. Otherwise, if {{code|id}} 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
|-
!scope="row"| Europe
| certyear || Albums only. Only up to 2014.
|-
!scope="row"| Finland
| artist domestic || Will use domestic certifications if {{para|domestic|true}}
|-
!scope="row"| France
| artist title type=album/single/video/compilation source certyear award number|| Use {{para|source|archive}} to use SNEP archives as source, requires {{para|certyear}}, {{para|award}} and {{para|number}} for multiple awards. Use {{para|source|infodisc}} for unofficial www.infodisc.fr tables (Manual search required)
|-
!scope="row"| GCC
| certyear || From 2009 to 2011 only.
|-
!scope="row"| Germany
| title artist type=album/single/video best=yes*/no || In cases where the best certification does not show up (known bug), set {{para|best|no}} to show the entire certification history
|-
!scope="row"| Greece
| id type certyear certweek domestic || Referenced from [[Wayback Machine]] archive, e.g. [https://web.archive.org/*/www.ifpi.gr/chart01.htm here]. <code>id</code> is the full 14 digit timestamp, e.g. 20070114174502. Use {{para|certyear}} and {{para|certweek}} for correct titles. Supports {{para|domestic|true}} where relevant (albums before 2011 and singles from 2021)
|-
!scope="row"| Hong Kong
| certyear || Albums only. Only up to 2008.
|-
!scope="row"| Hungary
| certyear ||
|-
!scope="row"| Ireland
| award number certyear || From 2005 to 2013 only.
|-
!scope="row"| Italy
| id title artist || From 2009 only. Use {{para|id}} for referencing the individual page (found at the end of the URL after clicking "Richiedi Targhetta"). Otherwise, can use {{para|title}} or {{para|artist}}.
|-
!scope="row"| Japan
| certmonth certyear digital streaming type || Set {{para|digital|true}} or {{para|type|ringtone}} for digital download certifications Set {{para|streaming|true}} uses the streaming certifications
|-
!scope="row"| Mexico
| artist title type || Manual search required
|-
!scope="row"| Netherlands
| artist type || Manual search required
|-
!scope="row"| New Zealand
| type=album/single/compilation id source domestic archive-url archive-date || Supports five sources: If {{para|source|archive}}, uses Radioscope certifications archive which only go April 2007 to July 2011. If {{para|source|book}}, uses {{cite Scapolo}} and {{para|id}} is the page number. If {{para|source|radioscope}}, uses the 2024 RadioScope certification search which has certifications since 2013. This option requires manual search. If {{para|source|newchart}}, uses the new website at aotearoamusiccharts.co.nz which has charts from 1975. In this case {{para|id}} is the date of the chart in the format YYYY-MM-DD. Setting {{para|domestic|true}} will use the domestic charts. Otherwise, or if {{para|source|oldchart}}, uses the defunct website at nztop40.co.nz which had charts from 1975. In this case {{para|id}} is the number of the chart and setting {{para|domestic|true}} will use the domestic charts. This option also requires setting {{para|archive-url}} and {{para|archive-date}}.
|-
!scope="row"| Nigeria
| || From 2023
|-
!scope="row"| Norway
| artist certyear ||
|-
!scope="row"| Philippines
| ||
|-
!scope="row"| Poland
| type=album/single/video/jazz award certyear || Uses ZPAV source with annual certlists if {{code|1995<{{=}}certyear<{{=}}2023}}, where {{code|award}} is mandatory to identify the section (Gold, Platinum and Diamond). Otherwise, can be used OLiS source, which requires manual search.
|-
!scope="row"| 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:
* [https://www.audiogest.pt/tabelas-oficiais-de-vendas-?lang=pt audiogest]: Used if {{code|certyear>{{=}}2018}}. Requires {{para|id|FILENAME}}, where filename is according to the stored URL {{code|http://www.audiogest.pt/uploads/files/FILENAME}}.
* Obsolete 1 [https://web.archive.org/web/20081212004610/http://www.afp.org.pt/estatisticas.php afp]: Used if {{para|source|archive}}. Works correctly only for {{code|2007<{{=}}certyear<{{=}}2010}}. Uses an archived version.
* Obsolete 2 [https://web.archive.org/web/20101119154945/http://artistas-espectaculos.com/topafp/pt/201047.htm artistas-espectaculos]: Used in all other cases. Requires {{para|id|XXXXYY}} where XXXX is the year and YY is the week in which the title charted. Requires {{para|archiveurl}} and {{para|archivedate}}, but will provide a helper link if they are not supplied. Works correctly only for {{code|2004<{{=}}certyear<{{=}}2010}}.
|-
!scope="row"| Russia
| certyear || Albums only
|-
!scope="row"| Singapore
| || Albums only. From 2019 to 2021 only
|-
!scope="row"| South Africa
| artist title ||
|-
!scope="row"| South Korea
| type streaming || From April 2018 only
|-
!scope="row"| Spain
| certyear certweek id type streaming digital artist title || If {{para|id}} is set, will use the El portal de Música entry to reach the specific title. In this case, {{code|id}} 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 {{para|id|coldplay-viva-la-vida-2}}. Also {{para|type}} is mandatory in this case. Otherwise, if {{para|certweek}} is used, {{para|certyear}} is the year for the certification and {{para|certweek}} is the week number on which the PDF is available from the dropdown [https://www.promusicae.es/listas-semanales/ available under the week tab]. This option supports {{para|streaming|true}}, {{para|digital|true}} and {{para|type|ringtone}}, relevant only for 2008 certifications. Otherwise, {{para|artist}} and/or {{para|title}} are used to search [https://www.elportaldemusica.es/awards/ the El portal de Música certification database].
|-
!scope="row"| Sweden
| certyear certweek position type=single/album artist source || Use {{para|source|artist}} to cite by {{para|artist}}. Use {{para|source|chart}} to cite by {{para|certyear}} and {{para|certweek}} from a chart, where {{para|position}} can be used to ease navigation. Use {{para|source|grammotex}} to cite from the grammotex website by {{para|id}}. Otherwise, can use {{para|certyear}} for an archived citation but only until 2011.
|-
!scope="row"| Switzerland
| artist title certyear || Will use <code>title</code> if available, <code>artist</code> as a second option, and <code>certyear</code> as last option.
|-
!scope="row"| Taiwan
| ||
|-
!scope="row"| Turkey
| certyear || From 2004 to 2009 only
|-
!scope="row"| United Kingdom
| artist title id type || Manual search required
|-
!scope="row"| United States
| title artist type=album/single/video/videosingle/ringtone/EP Spanish || Set {{para|Spanish|true}} for Latin certifications
|-
!scope="row"| Uruguay
| certyear ||
|}

== TemplateData ==
{{TemplateData header}}
<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 ==
* {{clc|Pages using cite certification with unknown parameters}}
* {{clc|Cite certification used with missing parameters}}

<includeonly>{{Sandbox other||

[[Category:Citation Style 1 specific-source templates]]
[[Category:Music external link templates]]
[[Category:Music source templates]]

}}</includeonly>

Template:Cite certification/doc - Revision history

Deleatur yhe: 1 revision imported

wikipedia>LuanCampSouza93 at 12:16, 24 August 2026