Template:Clarify/doc

Category:Template documentation#Clarify/doc

Adds a small inline note after a phrase, image, or usage that is difficult to understand and that needs clarification.

The template automatically sets the following categories: Category:Pages needing clarification

Usage


{{Clarify |date= |reason= }}

Template parameters

ParameterDescriptionDefaultStatus
date
1
datedate on which this template was addedemptyoptional
reason
2
reasonA brief note on what is expected, to make the text/image/usage before this submission cleareremptyoptional
<templatedata>JSON</templatedata> ./. {{TemplateBox}}
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 TemplateDataCommons-specific information

Category:TemplateData documentation

Adds a small inline note after a phrase, image, or usage that is difficult to understand and that needs clarification.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
datedate 1

date on which this template was added

Dateoptional
reasonreason 2

A brief note on what is expected, to make the text/image/usage before this submission clearer

Lineoptional

Additional information

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

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

Example

{{Clarify|date=2026-08-07|reason=what does this mean?}}

renders as:

[Please clarify: what does this mean? 7 August 2026]

See also

Warning templates

Disputed / inaccurate:

See also

Disputed / something missing:

  • {{Clarify}} – an in-line template
  • {{Lacking insignia source}}insignia
  • {{References missing}}generally for files where the description or depiction needs references
  • {{Datasource missing}}for own diagrams and graphics visualizing data that need references
  • {{Map datasource missing}}for own maps, especially those visualizing data, that need references
  • {{No source since}}deletion warning for missing essential source information
  • {{Sourcefield}} - produces a warning that a file appears to have an invalid entry in its "Source" parameter; for use on user talk pages, not file pages; less serious than the {{No source since}} warning; does not threaten deletion

Fictional (consciously):

  • {{Fake sports logo}} – for potentially serious confusion
  • {{Fictional}} – proposed insignia ("flag", "sign", "seal", "CoA", …)
  • {{Fake insignia}} — generic "faked" symbols, to facilitate identification but often not factually accurate to avoid copyright issues.
  • {{Fictitious flag}} – for potentially serious confusion

Generally:

Localization

To add your language to the list of languages supported by this template, please edit the template and add a row to the "{{LangSwitch|}}" construct. It takes the form "|xx= Your translation " (xx being the code of your language)

Category:Pages using duplicate arguments in template calls Category:TemplateData documentation Category:Template documentation