View source for Template:Improve images/doc

{{Documentation subpage}}

This template indicates that the article needs additional or more specific images. If placed on an article in the category "living people" it also invites the article subject to submit a photograph of themselves, directing them to [[Wikipedia:A picture of you]].

This template is intended for article space, and may be placed at the top or at the bottom of the page. Place it at the top when you feel the lack of images is urgent; place it at the bottom if you feel a top placement would draw undue attention to the article's image status. Either way, placing this template adds the article to the [[:Category:Articles needing additional images]] category (or one of its subcategories, see {{para|date}} below), where editors go to find articles in need of improvements related to images.

Use this template both for when the article needs ''more'' images, ''more specific'' images, and when the article needs ''better'' images (acknowledging that the article already contain a sufficient number of images).{{efn|Per [[Wikipedia:Templates for discussion/Log/2025_June_10#Template:Better image requested|this TfD discussion]] the {{tl|Better image requested}} template was merged into this template.}} If the article currently has no images, consider using {{tl|Image requested}} instead.

If the template is placed on the biography of a living person, it will display the additional text:{{xtn2|'''If this article is about you''' (or someone that you can photograph), Wikipedia wants your picture, and you are welcome to '''[[Wikipedia:A picture of you|submit your work]]'''.}}

== Parameters ==
* {{para|talk}} If there is an existing discussion on the article's talk page, you can link directly to the discussion using {{para|talk|Discussion name}}. Note: supply the talk section header directly; the linking is made automatically. If you omit this parameter, the talk page is linked to in general, unless placed on a page in the category "living people", in which case the invitation replaces the general talk link (but not any specific link supplied by including this parameter)
* {{para|type}} The text you supply for this parameter gets added just before the word "images", so you can have the template say "This article needs clearer images" by supplying {{para|type|clearer}}
* {{para|reason}} can be used to provide clarification on the request. This text gets appended to the end of the template

This template also includes standard support for the {{para|date}} parameter. Adding this parameter sorts the article into a dated subcategory of [[:Category:Articles needing additional images]] and out of the parent category, allowing the oldest problems to be identified and dealt with first. A [[Wikipedia:Bot policy|bot]] will add this parameter if it is omitted.

== Example usage ==
=== Basic usage ===
{{tlx|Improve images|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
{{Improve images|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}
=== Detailed usage ===
{{tlx|Improve images|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}|type{{=}}clearer|reason{{=}}The current image is blurry and the subject is difficult to identify.|talk{{=}}Image is blurry, does anyone have a better one?}}
{{Improve images|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}|type=clearer|reason=The current image is blurry and the subject is difficult to identify.|talk=Image is blurry, does anyone have a better one?}}

== TemplateData ==
{{TemplateData header}}

<templatedata>
{
	"params": {
		"type": {
			"label": "Image type",
			"description": "A simple description of the type of image requested",
			"example": "less blurry",
			"type": "string",
			"suggestedvalues": [
				"clearer",
				"biographical",
				"more relevant",
				"additional"
			],
			"suggested": true
		},
		"date": {
			"label": "Date",
			"description": "Month and year the template was placed",
			"type": "string",
			"required": true
		},
		"reason": {
			"label": "Reason",
			"description": "Suffix for the template to provide additional details",
			"example": "The current image is blurry.",
			"type": "string"
		},
		"talk": {
			"label": "Talk page discussion",
			"description": "The relevant discussion on the talk page",
			"type": "string"
		}
	},
	"description": "Adds a reader-facing request for images",
	"format": "inline"
}
</templatedata>

== See also ==
{{Media_request_templates}}

== Notes ==
{{notelist}}

<includeonly>{{Sandbox other||
<!-- Add categories and interlangs below this line -->

[[Category:Cleanup templates]]
[[Category:Image request templates]]
}}</includeonly>