Template:Heavily used template/doc: Difference between revisions

Latest revision as of 13:34, 16 August 2025

Note: This template is used on a great lot of pages. In order not to put too much load on the servers, edits should be kept to a bare minimum. Please discuss proposed changes on the talk page first.

Afterwards, changes can initially be done at and tested with Template:Heavily used template/sandbox.

Editing a template causes all pages that use the template to be re-rendered. If the template is used often, this can put a lot of load on the servers since it fills up the job queue.
Keep in mind that templates that are used on file description pages also show up on other wikis.

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Heavily used template.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ кыргызча ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာမန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha / ўзбекча ∙ Tiếng Việt ∙ 中文 ∙ 中文（简体） ∙ 中文（繁體） ∙ 中文（臺灣） ∙ +/−

This template marks all templates that are heavily used and should only be edited if needed.

The template automatically sets the following categories:

Heavily used templates (or Very heavily used templates if Parameter 3 is not empty)

Usage

Or use the shorthand

{{High-risk|… parameters as described …}}

This template is intended to be placed inside an ‎<includeonly> section at the top of the documentation subpage of highly used templates:

<includeonly>{{Heavily used template}}</includeonly>

Typically, this should be reserved for those with 7 or more transclusions (on at least 1 in 500 pages). See the Special:MostLinkedTemplates.

Template parameters

Parameter text is empty

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

Wikipedia's help about TemplateData • Commons-specific information

This template marks all templates that are heavily used and should only be edited if needed.

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
talk page	`1`	The full name of a template talk page, e.g. “Template talk:Xyz”.	Page name	optional
sandbox page	`2`	The full name of a template sandbox page.	Page name	optional
very heavily	`3`	any value when it is '''very''' heavily used, e.g. {{Heavily used template\|3=✔}}	String	optional
editparm	`edit`	creates a link for editing, when any value, e.g. {{Heavily used template\|edit=✔}}	String	optional

Additional information

The template is intended to be used in the following namespaces: the Template namespace

The template is intended to be used by the following user groups: Administrators

Localization

aragonés ∙ العربية ∙ asturianu ∙ azərbaycanca ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ čeština ∙ Deutsch ∙ Deutsch (Sie-Form) ∙ English ∙ British English ∙ español ∙ eesti ∙ فارسی ∙ suomi ∙ français ∙ Frysk ∙ galego ∙ עברית ∙ हिन्दी ∙ magyar ∙ հայերեն ∙ Ido ∙ italiano ∙ 日本語 ∙ қазақша ∙ қазақша (кирил) ∙ 한국어 ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ Bahasa Melayu ∙ မြန်မာဘာသာ ∙ مازِرونی ∙ norsk bokmål ∙ Nederlands ∙ norsk nynorsk ∙ polski ∙ português ∙ português do Brasil ∙ română ∙ русский ∙ sicilianu ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ Tiếng Việt ∙ 中文（简体） ∙ 中文（繁體） ∙ +/−

This template is localized through {{Autotranslate}}. The layout of the template can be found under Template:Heavily used template/layout.

To add your language to the list of languages supported by this template, please copy the code of Template:Heavily used template/en (or any other language version you prefer to translate) and replace the text strings in there (the form below can be used to create a translation, the English version is preloaded in the edit box). Please change the parameter lang from en (or whatever language you are translating) to the language code of your language.

@@ Line 1: / Line 1: @@
-{{TemplateBox
+<noinclude>{{high-use|3=+}}<!-- 350,000+ transclusions in 2025! --></noinclude>{{TemplateBox
+|1=1
+|1label-en=talk page
+|1d-en=The full name of a template talk page, e.g. “Template talk:Xyz”. <!--
+When this parameter is not specified, the name of the page (up to the first slash “/”) will be used. -->
+|1def=
+|1type=wiki-page-name
+|1stat=optional-
+|2=2
+|2label-en=sandbox page
+|2d-en=The full name of a template sandbox page. <!--
+When this parameter is not specified, the name of the page (up to the first slash “/”) will be used. -->
+|2def=
+|2type=wiki-page-name
+|2stat=optional-
+|3=3
+|3label-en=very heavily
+|3d-en=any value when it is '''very''' heavily used, e.g. <nowiki>{{Heavily used template|3=✔}}</nowiki>
+|3def=
+|3type=string
+|3stat=optional-
+|4=edit
+|4label-en=editparm
+|4d-en=creates a link for editing, when  any value, e.g. <nowiki>{{Heavily used template|edit=✔}}</nowiki>
+|4def=
+|4type=string
+|4stat=optional-
 |name=Heavily used template
-|desc=This template marks all templates that are heavily used and should only be edited if needed.
+|desc-en=This template marks all templates that are heavily used and should only be edited if needed.
+ |desc-it=Questo template marca tutti i template che sono ampiamente usati e dovrebbero essere modificati solo se necessario.
+ {{Mbox|type=serious|textstyle=text-align:center;|text=Don't use this template ''directly'' <code><nowiki><noinclude></nowiki></code> within the template code !<br>'''Use this template''' <code><nowiki><includeonly></nowiki></code> '''by the template documentation only'''.}}
 |namespace=template
 |usergroup=admin
-|usage-notes=This template is intended to be placed in a noinclude section at the top of highly used templates. Normally, this should be reserved for those with [[Special:MostLinkedTemplates|200,000+ links]].
+|usage-notes={{mbox|style=width:auto; margin:0 10%;|type=delete|image=|text=This template is intended to be placed inside an '''{{tag|includeonly|o}} section ''' {{color|#bf3c2c|'''at the top of the documentation subpage'''}} of highly used templates:
+<div style="margin-left:1em; margin-top:4px; margin-bottom:4px;"><code><nowiki><includeonly>{{Heavily used template}}</includeonly></nowiki></code></div>
+Typically, this should be reserved for those with {{mono|{{FORMATNUM:{{#expr:ceil({{NUMBEROFPAGES:R}}/500)}}}}}} or more transclusions (on at least 1 in 500 pages<!-- , or very essential templates -->). See the [[Special:MostLinkedTemplates]].}}
 |type=
 |example=
 |i18n-method=autotranslate
 |i18n-desc=
-|seealso=
+|seealso=*{{t0|Use sandbox|-}}
-|setscats=
+*{{T0|Heavily used module|-}}
+|setscats=* {{C|Heavily used templates}} (or {{C|Very heavily used templates}} if Parameter 3 is not empty)
 |lines=one
-|shorthand=
+|shorthand=High-risk
 |relieson=
-}}
+|useTemplateData=only
+}}<includeonly>
+[[Category:Template namespace templates]]
+[[Category:Internationalised marker templates]]
+[[Category:Template header templates]]
+</includeonly>