View source for Template:Image requested/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{redirect|Template:Reqp|the template for requesting a ping|Template:ReqP}}
{{High-use}}
{{tsh|RQP|reqp}}

== Usage ==
This template is placed at the top of an article's talk page to request that someone take a photograph for an article or add an image (from another source) to an article.  

It is a residual indicator, not a general-purpose "no image present" indicator (for that, use {{tl|improve images}}).  Editors placing this template on a talk page should provide information about what images or photographs are wanted, using more [[Template:Media request templates|media or request specific related templates (click to see the list)]].

'''Typical usage''' (all parameters are optional, most can be repeated):

<code><nowiki>{{Image requested | <topic subcategory> |of= <subject> |in= <country, region or city> }}</nowiki></code>

Free=yes block is for articles where there is a [[Wikipedia:Non-free content|non-free image]] present. Without it, someone may see "This article needs an image" and say "It already has an image", and maybe even remove the template. Some editors may also consider the complete absence of an image to be a more pressing concern than the need to replace a non-free one (or vice versa), and may want to sort requests that way.

=== Examples ===
{| class="wikitable"
|+ Usage examples of Template:Image requested, with sample output
|-
!scope="col"| Description
!scope="col"| Template
!scope="col"| Example
|-
!scope="row"| Basic table with no additional parameters
| <code><nowiki>{{Image requested}}</nowiki></code>
| <div class="center">{{Image requested|date=December 2012}}</div>
|-
!scope="row"| With "in" specified
| <code><nowiki>{{Image requested|in=the United States}}</nowiki></code>
| {{Image requested|in=the United States|date=December 2012}}
|-
!scope="row"| With subject category parameter
| <code><nowiki>{{Image requested|of=consumer electronics}}</nowiki></code>
| {{Image requested|of=consumer electronics|date=December 2012}}
|-
!scope="row"| With subject category parameter and multiple "in" specified
| <code><nowiki>{{Image requested|of=rivers and waterfalls|in=France|in2=Germany}}</nowiki></code>
| {{Image requested|of=rivers and waterfalls|in=France|in2=Germany|date=December 2012}}
|-
!scope="row"| With subject category, in parameter and additional information parameter
| <code><nowiki>{{Image requested|architecture|in=England|of=the main entrance}}</nowiki></code>
| {{Image requested|architecture|in=England|of=the main entrance|date=December 2012}}
|-
!scope="row"| With "<nowiki>|</nowiki>free=yes" parameter
| <code><nowiki>{{Image requested|free=yes}}</nowiki></code>
| {{Image requested|free=yes|date=December 2012}}
|-
!scope="row"| With "<nowiki>|</nowiki>small=yes" parameter
| <code><nowiki>{{Image requested|small=yes}}</nowiki></code>
| {{Image requested|small=yes|date=December 2012}}
|}

=== Categorize your request ===
Although it is possible to add just the template <nowiki>{{image requested}}</nowiki> to a talk page it is '''strongly advised''' that you add at least one category parameter.  If you don't categorize your request, it will be placed in [[:Category:Wikipedia requested photographs]], and may not receive attention from subject&nbsp;/&nbsp;regional photographers, and it is more likely to be deleted by other editors.

For example, if a picture of a specific car is required then the following should be added to the talk page: <nowiki>{{image requested|cars}}</nowiki> — this will then be added to [[:Category:Wikipedia requested images of cars]].

Picture of places are sorted by location, for example <code><nowiki>{{image requested|in=Norway}}</nowiki></code>

Adding more than one subject to the list of parameters will bring it to the attention of more people. If, for example, the subject is found in a location (or predominantly is in one country) then you can add more additional categories like so: <code><nowiki>{{image requested|computer equipment|in=Russia}}</nowiki></code>

For requests of people, reason for notoriety (i.e. occupation) and where they are know (born, lived, died, worked) is recommend. For example: <code><nowiki>{{image requested||American football people|people of Pennsylvania}}</nowiki></code>

If you are requiring a specific image of the article subject, it is possible to add detailed text. For example, in the talk page of a specific building: <code><nowiki>{{image requested|architecture|in=London|of=main entrance hall}}</nowiki></code>

For a full list of categories in use, go to [[:Category:Wikipedia requested photographs]]. When selecting a category, please click down to the most relevant sub-category, and select the most appropriate to the topic of the article requiring a photograph.

Adding more than one [[:Category:Wikipedia requested photographs by subject|subject category]] in the template is recommended.

=== Explain your request ===
If the subject matter isn't perfectly obvious (such as an article about a physical object), please explain your request on the talk page. It is very helpful to give photographers your ideas, particularly for abstract ideas, such as legal and philosophical concepts.

If you have a specific idea for another image, then use the {{para|of=}} parameter to name the specific picture that you would like. This is particularly helpful if there are already images in the article.

Unexplained and uncategorized templates may be deleted by any editor.

=== Parameters ===
The template employs several optional data field parameters as described hereafter.

<div style="width:28em; background: #dddddd; border: 1px solid black; padding: 0.5em 1em 0.5em 1em;">
<syntaxhighlight lang="wikitext">{{Image requested
|1=
|2=
|3=
|of=
|in=
|in2=
|in3=
|in4=
|in5=
|in6=
|in7=
|in8=
|in9=
|in10=
|in11=
|in12=
|in13=
|in14=
|in15=
|in16=
|in17=
|in18=
|in19=
|in20=
|category=
|free=
|collapsed=
|small=
}}</syntaxhighlight></div>

=== Parameters legend ===
* '''{{para|1}}''' – may be passed to indicate an appropriate topic subcategory. The [[positional parameter]] alternatively may be unnamed (e.g., instead of "|1=xxx", the string "|xxx" would have the same results as "|1=xxx").
:Up to three [[positional parameter]]s (e.g., '''1=''', '''2=''', '''3=''') may be used to specify appropriate subcategories.  For example, use <nowiki>{{image requested|1=sportspeople|2=musicians}}</nowiki> or <nowiki>{{image requested|sportspeople|musicians}}</nowiki> to add the page to [[:Category:Wikipedia requested photographs of sportspeople]] and [[:Category:Wikipedia requested photographs of musicians]].
* '''{{para|of}}''' – may be passed to indicate what the subject of the photograph should be.
* '''{{para|in}}''' – specifies where the photograph may best be taken, and adds the article to the appropriate location subcategory, e.g. <nowiki>{{image requested|in&#61;Wisconsin}}</nowiki> adds the article to [[:Category:Wikipedia requested photographs in Wisconsin]]. If there is also a "Wikipedians" category for the location (in that example, if Category:Wikipedians in Wisconsin also exists), it displays a link suggesting that those users may be able to help. 
: Additional '''in2=''', '''in3=''', ... up to '''in20=''' parameters may be used to specify up to twenty location categories (such as for roads that cross multiple counties or celebrities and others who may frequent multiple locations).
* '''{{para|collapsed}}''' – may be set to collapsed=yes to close up the template message box.
: If more than six locations are specified (e.g., in=, in2=, in3=, in4=, in5=, in6=, in7= ... are used), the template message box will collapse automatically without using the collapsed= parameter. Specifying collapsed=no will keep the template message box expanded, no matter how many in= parameters are specified (i.e. no matter how many locations are specified).
* '''{{para|small}}''' – toggles the message box from standard size to small, if small=yes.
* '''{{para|category}}''' – suppresses the automatic categorization if category=no.
* '''{{para|free}}''' – if '''free=yes''', the substituted text will explicitly request a freely-licensed photograph.

=== Notes ===
* If no category or location parameters are present, this template adds the article to [[:Category:Wikipedia requested photographs]].
* To avoid needlessly cluttering up talk pages, it is usually appropriate to remove any unused parameters from the template. A common initial configuration for the template includes the following basic parameters:
<div class="center"><code><nowiki>{{image requested| |of=|in=|in2=|in3=}}</nowiki></code></div>
* If the specific location or topic does not have a corresponding requested-photographs category, then the page is also placed in one of the subcategories of [[:Category:Wikipedia requested images in non-existent categories]]. This assists editors in ensuring that image requests are properly categorised.

== Variants from using this template ==
As a variant, some talk page WikiProject banners can also list an article as needing a photograph. However, where the talk page banners do not highlight a need for a photograph in an article or where photographs for the article are requested in more than three locations, this template may be placed on the ''talk'' (discussion) page of the article, instead.

Another variant is to find existing photographs that might meet the needs.

== Redirects ==
Redirects to this template are considered "copies". Some of the more natural phrases that redirect here include {{tl|Image needed}}; {{tl|Picture requested}}, {{tl|Photo requested}} and {{tl|Photograph requested}}; and {{tl|Requested image}}, {{tl|Requested picture}}, {{tl|Requested photo}} and {{tl|Requested photograph}}.

== See also ==
*[[WP:TALK#CREATE]]
{{Image request templates}}

==TemplateData==
{{TemplateDataHeader}}
<templatedata>
{
	"params": {
		"in": {
			"label": "Country or region",
			"example": "United States",
			"type": "line",
			"description": "Location x where \"Wikipedians in x\" might be able to help provide the image"
		},
		"of": {
			"label": "Subject",
			"description": "What the subject of the requested image should be",
			"example": "The missile",
			"type": "line"
		}
	},
	"description": "Informs readers that an image would improve the article",
	"format": "block"
}
</templatedata>

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Image request templates]]
[[Category:Request templates]]
[[Category:Templates needing talk links and other improvements]]

}}</includeonly>