View source for Template:Citation needed/doc

{{Redirect|Template:Proveit|the template about the referencing gadget|Template:User ProveIt}}
{{Documentation subpage}}
{{High-use}}
{{cascade-protected template}}
{{Notice|An introductory version of this documentation is provided at [[Wikipedia:Citation needed]].}}
{{Template shortcut|cn|fact|refplease|proveit|citeneeded|uncited}}
{{Lua|Module:Unsubst|Module:Check for unknown parameters}}
<noinclude>{{pp-semi-indef}}<!--persistent vandalism from anon users--></noinclude>
[[File:Webcomic xkcd - Wikipedian protester - English.svg|thumb|right|alt=xkcd comic "Wikipedian Protestor": as a politician addresses a crowd, a protestor within the crowd holds up a sign reading "[CITATION NEEDED]".|&lsqb;[[Wikipedia:citation needed|citation needed]]&rsqb;]]
{{Tlb|Citation needed}} is a [[Help:Template|template]] used to identify claims in articles, particularly if questionable, that need a [[Wikipedia:Citing sources|citation]] to a [[WP:Reliable sources|reliable source]]. This template produces the superscripted message&nbsp;{{citation needed|date=May 2013|reason=example}} and is installed with no spaces directly after punctuation.

== Usage ==
* {{tnull|Citation needed|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
* {{tnull|Citation needed|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}|reason{{=}}''Your explanation here''}}

== Notes ==
* The {{para|date}} parameter consists of the full English name of the current month (with initial capital and rest lowercase), a space, and the year. For example, "{{xt|January 2013}}" but not "{{!xt|jan13}}" or "{{!xt|January 23, 2013}}". Deviation from this rule will place the article in [[:Category:Articles with invalid date parameter in template]]. 
** To automatically add the current date, you can use [[Help:Substitution|substitution]] like this: <syntaxhighlight lang="wikitext" inline>{{Redirect|Template:Proveit|the template about the referencing gadget|Template:User ProveIt}}
{{Documentation subpage}}
{{High-use}}
{{cascade-protected template}}
{{Notice|An introductory version of this documentation is provided at [[Wikipedia:Citation needed]].}}
{{Template shortcut|cn|fact|refplease|proveit|citeneeded|uncited}}
{{Lua|Module:Unsubst|Module:Check for unknown parameters}}

[[File:Webcomic xkcd - Wikipedian protester - English.svg|thumb|right|alt=xkcd comic "Wikipedian Protestor": as a politician addresses a crowd, a protestor within the crowd holds up a sign reading "[CITATION NEEDED]".|&lsqb;[[Wikipedia:citation needed|citation needed]]&rsqb;]]
{{Tlb|Citation needed}} is a [[Help:Template|template]] used to identify claims in articles, particularly if questionable, that need a [[Wikipedia:Citing sources|citation]] to a [[WP:Reliable sources|reliable source]]. This template produces the superscripted message&nbsp;{{citation needed|date=May 2013|reason=example}} and is installed with no spaces directly after punctuation.

== Usage ==
* {{tnull|Citation needed|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
* {{tnull|Citation needed|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}|reason{{=}}''Your explanation here''}}

== Notes ==
* The {{para|date}} parameter consists of the full English name of the current month (with initial capital and rest lowercase), a space, and the year. For example, "{{xt|January 2013}}" but not "{{!xt|jan13}}" or "{{!xt|January 23, 2013}}". Deviation from this rule will place the article in [[:Category:Articles with invalid date parameter in template]]. 
** To automatically add the current date, you can use [[Help:Substitution|substitution]] like this: <syntaxhighlight lang="wikitext" inline><span class="error">Template loop detected: [[:Template:Citation needed]]</span></syntaxhighlight>. 
** If the {{para|date}} parameter is not given, a [[Wikipedia:Bots|bot]] will soon add it ([[User:AnomieBOT|AnomieBOT]]'s TagDater task) but it's better if you add it yourself to avoid an extra edit to the article's history.
* The {{para|reason}} parameter is for an explanation why you think the material needs a source. It is optional but very helpful. It is displayed as a [[tooltip]] in some browsers (hover the mouse here {{Citation needed|reason=If this text is displayed, the reason parameter is working in your browser|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} to check behaviour of your browser). For example, the following usage might be appropriate to the claim that "Humphrey Bogart was an avid snooker player": <br/> <syntaxhighlight lang="wikitext" inline>{{Citation needed|reason=This claim needs a reliable source; Bogart was a famous actor but his major biographies don't mention snooker.|date=July 2024}}</syntaxhighlight>
** Use only [[plain text]] for the {{para|reason}} parameter. It does not support [[Help:Wiki markup|wiki markup]] like wikilinks, which can mess up the tooltip.
** Double quotation marks used within the {{para|reason}} parameter will likewise mess up the tooltip; use single quotes or the HTML code <code>&amp;quot;</code> instead.
** If omitted, the tooltip "This claim needs references to reliable sources." is used by default.
* This template should usually be installed directly ''after'' punctuation, such as a full stop (period) or a comma.
* Use of this template places the article into [[:Category:All articles with unsourced statements]] and [[:Category:Articles with unsourced statements from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]] (example; past months are listed in [[:Category:Articles with unsourced statements]]).
* Remove the template when you add a citation for a statement.

== Examples ==
=== Example 1 ===
This sentence shows the template used at the end.<syntaxhighlight lang="wikitext" inline>{{Citation needed|reason=Reliable source needed for the whole sentence|date=July 2004}}</syntaxhighlight>

This wikitext will be rendered as follows:

:This sentence shows the template used at the end.{{Citation needed|reason=Reliable source needed for the whole sentence|date=July 2004}}

=== Example 2 ===
:[[Humphrey Bogart]] was an avid snooker player.<syntaxhighlight lang="wikitext" inline>{{Citation needed|date=July 2004}}</syntaxhighlight>

The template indicates that it may be that Humphrey Bogart played snooker at some point and it may be that he was enthusiastic about the game but no ''reliable'', ''published'' sources were given to verify it and the information is not considered [[common knowledge]]. 

:[[Humphrey Bogart]] was an avid snooker player.{{Citation needed|date=July 2004}}

=== Example 3 ===
If it is considered that he might have played snooker but was not an avid player, a reason for the need of a citation may be given, displayed as a tooltip when the mouse hovers on "citation needed":

:[[Humphrey Bogart]] was an avid snooker player.<syntaxhighlight lang="wikitext" inline>{{Citation needed|date=July 2004|reason=Only aware he was photographed playing once. Not aware of any source that claims he played a lot.}}</syntaxhighlight>

:[[Humphrey Bogart]] was an avid snooker player.{{Citation needed|date=July 2004|reason=Only aware he was photographed playing once. Not aware of any source that claims he played a lot.}}

In this example, it may be better to use the {{tl|Citation needed span}} template, which has slightly different syntax, to highlight the word "avid".

== When not to use this template ==
Contentious material about [[Wikipedia:Biographies of living persons|living persons]] that is unsourced or poorly sourced should be '''removed immediately'''. Do not tag it; immediately remove it. This includes material that is disparaging, misrepresentative, insulting, harmful, or possibly [[libelous]]. For some policy about this, see the sections [[Wikipedia:Biographies of living persons#Remove contentious material that is unsourced or poorly sourced|"Remove contentious material that is unsourced or poorly sourced"]] at [[Wikipedia:Biographies of living persons]] and [[Wikipedia:Verifiability#Burden of evidence|"Burden of evidence"]] at [[Wikipedia:Verifiability]].

The {{tlf|Citation needed}} template is intended for use when there is a general question of the verifiability of a statement, or when an editor believes that a reference verifying the statement should be provided. Other templates are available for other or more specific issues; see the [[#Article_message_box_templates|list of inline templates]]. For example, claims that you think are incorrect should be tagged with {{Tl|Dubious}}, and those which represent a non-neutral view should be tagged with {{Tl|POV statement}}. Being specific about the nature of the problem will help other editors correct it.

Within a [[Wikipedia:lead section|lead section]] that is clearly written as a summary of a substantially sourced article:
* statements that are supported with citations within the body of the article should not be tagged
* statements that are {{em|not}} supported in the article body should be tagged with {{tl|Not verified in body}}
* statements that are not even {{em|mentioned}} in the article body should be tagged with {{tl|Lead extra info}}

If you have the time and ability to find an authoritative reference, please do so. Then add the citation yourself, or correct the article text. After all, the ultimate goal is not to merely identify problems, but to fix them.

While an editor may add this template to any uncited passage for any reason, many editors object to what they perceive as overuse of this tag, particularly in what is known as "[[drive-by]]" tagging, which is applying the tag without attempting to address the issues at all. Consider whether adding this tag in an article is the best approach before using it, and use it judiciously. Wikipedia's [[WP:Verifiability|verifiability policy]] requires neither reliable sources for [[Common knowledge|common well-known facts]] (e.g., "the Moon orbits the Earth"), nor that citations be repeated through every sentence in a paragraph. All direct quotations and facts whose accuracy might be challenged (e.g., statistics) require citations. See [[WP:MINREF]] for the list of material that is absolutely required to be followed by an [[Wikipedia:Inline citation|inline citation]], rather than a [[Wikipedia:General references|general reference]] or no citation at all. Also note that the [[WP:BURDEN|burden of evidence]] lies with the editor who adds or restores material.

This template is intended for specific passages that need citation. For entire articles or sections that contain significant material lacking citations (rather than just specific short passages), there are other, more appropriate templates, such as {{Tl|Unreferenced}} and {{Tl|More citations needed}} (for whole articles) as well as {{Tl|Unreferenced section}} and {{Tl|More citations needed section}} (for sections of articles).

Do not use this template to tag policies or guidelines.

== How to respond to this tag ==
The addition of this tag is a request for an inline citation to support the tagged statement. If you are able to provide a citation to support the claim, then please do so.

Except for [[WP:Biographies of living persons|contentious claims about living people]], which should be immediately removed if not cited, there is [[WP:There is no deadline|no specific deadline]] for providing citations. Please do not delete information that you believe is correct solely because no one has provided a citation within an arbitrary time limit. If there is some uncertainty about its accuracy, most editors are willing to wait at least a month to see whether a citation can be provided.

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"description": "The template is used to identify claims in articles, particularly if questionable, that lack a citation to a reliable source.",
	"params": {
		"date": {
			"label": "Month and year",
			"description": "Provides the month and year of the citation request; e.g., 'January 2013', but not 'jan13'",
			"type": "string",
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"suggested": true
		},
		"reason": {
			"label": "Reason for citation",
			"description": "A reason as to why, or for what content, the citation is needed; use single quotes, if any",
			"type": "string"
		}
	}
}
</templatedata>

== Tracking categories ==
* {{clc|Pages containing citation needed template with unsupported parameters}} – a hidden maintenance/tracking category which is added to pages using this template with unsupported parameters
* {{clc|All articles with unsourced statements}}

== See also ==
* [[Citation needed]], Wikipedia's mainspace article about this template
* [[Template:Citation needed span]], variant of this template that explicitly attaches to a portion of text
* [[Template:Not verified in body]], a similar template specifically for the lead of articles
* [[Template:Medical citation needed]]
* [[Template:More citations needed]]
* [[Wikipedia:Citing sources]], especially [[Wikipedia:Citing sources#Unsourced material|Unsourced material]]
* [[Wikipedia:Reliable sources]]
* [[Wikipedia:Template index/Cleanup#Verifiability and sources]]
* [[Wikipedia:Template index/Sources of articles]]
* [[Wikipedia:Verifiability]]

=== Article message box templates ===
* {{Tl|Cite check}}: article or section may have inappropriate or misinterpreted citations.
* {{Tl|More citations needed}}: article or section has weak or incomplete sources, references, or citations.
* {{Tl|Unreferenced}} and {{Tl|Unreferenced section}}: article or section has no sources, references, or citations given at all.
* Citation method and style
** {{Tl|Citation style}}
** {{Tl|No footnotes}}

{{Inline cleanup tags}}

{{Sandbox other||
<!-- Template categories -->
[[Category:Inline citation and verifiability dispute templates]]
[[Category:Templates that add a tracking category]]

}}</syntaxhighlight>. 
** If the {{para|date}} parameter is not given, a [[Wikipedia:Bots|bot]] will soon add it ([[User:AnomieBOT|AnomieBOT]]'s TagDater task) but it's better if you add it yourself to avoid an extra edit to the article's history.
* The {{para|reason}} parameter is for an explanation why you think the material needs a source. It is optional but very helpful. It is displayed as a [[tooltip]] in some browsers (hover the mouse here {{Citation needed|reason=If this text is displayed, the reason parameter is working in your browser|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} to check behaviour of your browser). For example, the following usage might be appropriate to the claim that "Humphrey Bogart was an avid snooker player": <br/> <syntaxhighlight lang="wikitext" inline>{{Citation needed|reason=This claim needs a reliable source; Bogart was a famous actor but his major biographies don't mention snooker.|date=July 2024}}</syntaxhighlight>
** Use only [[plain text]] for the {{para|reason}} parameter. It does not support [[Help:Wiki markup|wiki markup]] like wikilinks, which can mess up the tooltip.
** Double quotation marks used within the {{para|reason}} parameter will likewise mess up the tooltip; use single quotes or the HTML code <code>&amp;quot;</code> instead.
** If omitted, the tooltip "This claim needs references to reliable sources." is used by default.
* This template should usually be installed directly ''after'' punctuation, such as a full stop (period) or a comma.
* Use of this template places the article into [[:Category:All articles with unsourced statements]] and [[:Category:Articles with unsourced statements from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]] (example; past months are listed in [[:Category:Articles with unsourced statements]]).
* Remove the template when you add a citation for a statement.

== Examples ==
=== Example 1 ===
This sentence shows the template used at the end.<syntaxhighlight lang="wikitext" inline>{{Citation needed|reason=Reliable source needed for the whole sentence|date=July 2004}}</syntaxhighlight>

This wikitext will be rendered as follows:

:This sentence shows the template used at the end.{{Citation needed|reason=Reliable source needed for the whole sentence|date=July 2004}}

=== Example 2 ===
:[[Humphrey Bogart]] was an avid snooker player.<syntaxhighlight lang="wikitext" inline>{{Citation needed|date=July 2004}}</syntaxhighlight>

The template indicates that it may be that Humphrey Bogart played snooker at some point and it may be that he was enthusiastic about the game but no ''reliable'', ''published'' sources were given to verify it and the information is not considered [[common knowledge]]. 

:[[Humphrey Bogart]] was an avid snooker player.{{Citation needed|date=July 2004}}

=== Example 3 ===
If it is considered that he might have played snooker but was not an avid player, a reason for the need of a citation may be given, displayed as a tooltip when the mouse hovers on "citation needed":

:[[Humphrey Bogart]] was an avid snooker player.<syntaxhighlight lang="wikitext" inline>{{Citation needed|date=July 2004|reason=Only aware he was photographed playing once. Not aware of any source that claims he played a lot.}}</syntaxhighlight>

:[[Humphrey Bogart]] was an avid snooker player.{{Citation needed|date=July 2004|reason=Only aware he was photographed playing once. Not aware of any source that claims he played a lot.}}

In this example, it may be better to use the {{tl|Citation needed span}} template, which has slightly different syntax, to highlight the word "avid".

== When not to use this template ==
Contentious material about [[Wikipedia:Biographies of living persons|living persons]] that is unsourced or poorly sourced should be '''removed immediately'''. Do not tag it; immediately remove it. This includes material that is disparaging, misrepresentative, insulting, harmful, or possibly [[libelous]]. For some policy about this, see the sections [[Wikipedia:Biographies of living persons#Remove contentious material that is unsourced or poorly sourced|"Remove contentious material that is unsourced or poorly sourced"]] at [[Wikipedia:Biographies of living persons]] and [[Wikipedia:Verifiability#Burden of evidence|"Burden of evidence"]] at [[Wikipedia:Verifiability]].

The {{tlf|Citation needed}} template is intended for use when there is a general question of the verifiability of a statement, or when an editor believes that a reference verifying the statement should be provided. Other templates are available for other or more specific issues; see the [[#Article_message_box_templates|list of inline templates]]. For example, claims that you think are incorrect should be tagged with {{Tl|Dubious}}, and those which represent a non-neutral view should be tagged with {{Tl|POV statement}}. Being specific about the nature of the problem will help other editors correct it.

Within a [[Wikipedia:lead section|lead section]] that is clearly written as a summary of a substantially sourced article:
* statements that are supported with citations within the body of the article should not be tagged
* statements that are {{em|not}} supported in the article body should be tagged with {{tl|Not verified in body}}
* statements that are not even {{em|mentioned}} in the article body should be tagged with {{tl|Lead extra info}}

If you have the time and ability to find an authoritative reference, please do so. Then add the citation yourself, or correct the article text. After all, the ultimate goal is not to merely identify problems, but to fix them.

While an editor may add this template to any uncited passage for any reason, many editors object to what they perceive as overuse of this tag, particularly in what is known as "[[drive-by]]" tagging, which is applying the tag without attempting to address the issues at all. Consider whether adding this tag in an article is the best approach before using it, and use it judiciously. Wikipedia's [[WP:Verifiability|verifiability policy]] requires neither reliable sources for [[Common knowledge|common well-known facts]] (e.g., "the Moon orbits the Earth"), nor that citations be repeated through every sentence in a paragraph. All direct quotations and facts whose accuracy might be challenged (e.g., statistics) require citations. See [[WP:MINREF]] for the list of material that is absolutely required to be followed by an [[Wikipedia:Inline citation|inline citation]], rather than a [[Wikipedia:General references|general reference]] or no citation at all. Also note that the [[WP:BURDEN|burden of evidence]] lies with the editor who adds or restores material.

This template is intended for specific passages that need citation. For entire articles or sections that contain significant material lacking citations (rather than just specific short passages), there are other, more appropriate templates, such as {{Tl|Unreferenced}} and {{Tl|More citations needed}} (for whole articles) as well as {{Tl|Unreferenced section}} and {{Tl|More citations needed section}} (for sections of articles).

Do not use this template to tag policies or guidelines.

== How to respond to this tag ==
The addition of this tag is a request for an inline citation to support the tagged statement. If you are able to provide a citation to support the claim, then please do so.

Except for [[WP:Biographies of living persons|contentious claims about living people]], which should be immediately removed if not cited, there is [[WP:There is no deadline|no specific deadline]] for providing citations. Please do not delete information that you believe is correct solely because no one has provided a citation within an arbitrary time limit. If there is some uncertainty about its accuracy, most editors are willing to wait at least a month to see whether a citation can be provided.

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"description": "The template is used to identify claims in articles, particularly if questionable, that lack a citation to a reliable source.",
	"params": {
		"date": {
			"label": "Month and year",
			"description": "Provides the month and year of the citation request; e.g., 'January 2013', but not 'jan13'",
			"type": "string",
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"suggested": true
		},
		"reason": {
			"label": "Reason for citation",
			"description": "A reason as to why, or for what content, the citation is needed; use single quotes, if any",
			"type": "string"
		}
	}
}
</templatedata>

== Tracking categories ==
* {{clc|Pages containing citation needed template with unsupported parameters}} – a hidden maintenance/tracking category which is added to pages using this template with unsupported parameters
* {{clc|All articles with unsourced statements}}

== See also ==
* [[Citation needed]], Wikipedia's mainspace article about this template
* [[Template:Citation needed span]], variant of this template that explicitly attaches to a portion of text
* [[Template:Not verified in body]], a similar template specifically for the lead of articles
* [[Template:Medical citation needed]]
* [[Template:More citations needed]]
* [[Wikipedia:Citing sources]], especially [[Wikipedia:Citing sources#Unsourced material|Unsourced material]]
* [[Wikipedia:Reliable sources]]
* [[Wikipedia:Template index/Cleanup#Verifiability and sources]]
* [[Wikipedia:Template index/Sources of articles]]
* [[Wikipedia:Verifiability]]

=== Article message box templates ===
* {{Tl|Cite check}}: article or section may have inappropriate or misinterpreted citations.
* {{Tl|More citations needed}}: article or section has weak or incomplete sources, references, or citations.
* {{Tl|Unreferenced}} and {{Tl|Unreferenced section}}: article or section has no sources, references, or citations given at all.
* Citation method and style
** {{Tl|Citation style}}
** {{Tl|No footnotes}}

{{Inline cleanup tags}}

<includeonly>{{Sandbox other||
<!-- Template categories -->
[[Category:Inline citation and verifiability dispute templates]]
[[Category:Templates that add a tracking category]]

}}</includeonly>