Jump to content

Wikipedia:Manual of Style/Images

Page semi-protected
From Wikipedia, the free encyclopedia

This page provides an overview of how images are used on Wikipedia. For detailed guidelines, see the Image use policy. For instructions on uploading and including images, see Help:Files.

Choosing images

Pertinence and encyclopedic nature

A helicopter hovers above the Sydney Opera House. The helicopter is too far away to make out fine details, and only a small portion of the Sydney Opera House's roof is in frame.
This image of a helicopter over the Sydney Opera House shows neither adequately.

Images must be significant and relevant in the topic's context, not primarily decorative. Each image in an article should have a clear and unique illustrative purpose and serve as an important illustrative aid to understanding the subject. When possible, find better images and improve captions rather than simply removing poor or inappropriate ones, especially on pages with few visuals. However, not every article needs images, and too many can be distracting or cause undue weight: usually, less is more.

See also Wikipedia:Manual of Style/Icons § Encyclopedic purpose on misuse of icons and other elements for decorative intent.

Images should look like what they are meant to illustrate, regardless of whether they are authentic. For example, a painting of a cupcake may be an acceptable image for Cupcake, but a real cupcake that has been decorated to look like something else entirely is less appropriate. Similarly, an image of a generic-looking cell under a light microscope might be useful on multiple articles, as long as there are no visible differences between the cell in the image and the typical appearance of the cell being illustrated.

Strive for variety. For example, in an article with numerous images of persons (e.g. Running), seek to depict a variety of ages, genders, and ethnicities. If an article on a military officer already shows its subject in uniform, then two more formal in-uniform portraits would add little interest or information, but a map of an important battle and an image of its aftermath would be more informative. Resist the temptation to overwhelm an article with images of marginal value simply because many images are available. Prioritize quality over quantity.

Ethnic groups

Articles about ethnic groups or similarly large human populations should not be illustrated by a photomontage or gallery of images of group members.[a] This does not apply to articles about things such as body parts or haircuts.[b]

Image quality

Use the best quality images available. Poor-quality images—dark or blurry; poor-quality video stills; showing the subject too small, hidden in clutter, ambiguous, or at an awkward angle; and so on—should not be used unless absolutely necessary. Think carefully about which images best illustrate the subject matter. For example:

  • An image of a white-tailed eagle is useless if the bird appears as a speck in the sky.
  • A biography should lead with a portrait photograph of the subject alone, not with other people.
  • A suitable picture of a hammerhead shark would show its distinctive hammer-like head, to distinguish it from other sharks.
  • A map of Moldova should show its frontiers with Romania and Ukraine, so people may know where the country is located in relation to its neighbors.
  • Rice is best represented with an image of plain rice, not fried rice.
  • Intangible concepts can be illustrated; for example, two boars butting heads portrays aggression.

Pages using seals, flags, banners, logos, or other symbols to represent governments, organizations, and institutions should use the version prescribed by that entity when available. These are preferable to amateur creations of similar quality, including photographs of physical representations of emblems.

Avoid presenting textual information as images

Scale references

An image sometimes includes a familiar object to communicate scale. Such fiducial markers should be as culturally universal and standardized as possible: rulers, matches, batteries, pens, pencils, footballs (soccer balls), people and their body parts, vehicles, and famous structures such as the Eiffel Tower are good choices, but many others are possible. Such objects as coins, banknotes, and sheets of paper are less satisfactory because they are specific to given locales, but may be better than none at all since at least the general scale is still communicated.

Quantitative data, if available, should still be given in the caption or the article.

Offensive images

Options to hide an image

Wikipedia is not censored: its mission is to present information, including information which some may find offensive. However, a potentially offensive image—one that would be considered vulgar, horrifying, or obscene by typical Wikipedia readers[nb 1]—should be included only if it is treated in an encyclopedic manner, i.e. only if its omission would cause the article to be less informative, relevant, or accurate, and no equally suitable alternative is available. Images should respect conventional expectations of readers for a given topic as much as is possible without sacrificing the quality of the article. Avoid images that contain irrelevant or extraneous elements that might seem offensive or harassing to readers; for example, photographs taken in a pornographic context would normally be inappropriate for articles about human anatomy.

Images for the lead

It is common for an article's lead or infobox to carry a representative image—such as of a person or place, a book or album cover—to give readers visual confirmation that they've arrived at the right page.

For some topics, selecting the lead image can be difficult. While Wikipedia is not censored, lead images should be selected with care (see § Offensive images, above). The lead image is perhaps the first thing to catch the reader's eye, so avoid lead images that readers would not expect to see there. Unlike other content beyond the lead, the lead image should be chosen with these considerations in mind.

Advice on selecting a lead image includes:

  • Lead images should be natural[c] and appropriate representations of the topic; they should not only illustrate the topic specifically, but also be the type of image used for similar purposes in high-quality reference works, and therefore what our readers will expect to see. Lead images are not required; not having a lead image may be the best solution if there is no easy representation of the topic.
  • Lead images should be of least shock value; an alternative image that accurately represents the topic without shock value should always be preferred. For example, using this image of deportees being subjected to selection as the lead image of The Holocaust is far preferable to the appropriate images that appear later in the article that show the treatment of the prisoners or corpses from the camps. Where it is impossible to avoid using a lead image with perceived shock value, for example in articles on human genitalia, editors may assume, per Wikipedia:Content disclaimer, that readers are aware that such articles may contain such images.
  • Articles about ethnic groups or similarly large human populations should not be illustrated by a photomontage or gallery of images of group members.[a] This does not apply to articles about things such as body parts or haircuts.[b]
  • On some mobile platforms, such as the official Wikipedia mobile app and mobile site, an article's first image may be displayed at the top of the article, even if it appears well into the article in the desktop view. When placing images consider whether this phenomenon may mislead or confuse readers using mobile devices.

How to place an image

Syntax

Basic example (producing this image):

[[File:Siberian Husky pho.jpg|thumb|alt=A white dog in a harness playfully nuzzles a young boy.|A [[Siberian Husky]] used as a pack animal]]

A white dog in a harness playfully nuzzles a young boy.
A Siberian Husky used as a pack animal
  • File:Siberian Husky pho.jpg The file (image) name must be exact (including capitalization, punctuation and spacing) and must include .jpg, .png or other extension. (Image: and File: work the same.) If Wikipedia and Wikimedia Commons both have an image with the specified name, the Wikipedia version is the one that will appear in the article.
  • thumb is required in most cases
  • alt=A white dog in a harness playfully nuzzles a young boy. Alt text is meant for those who cannot see the image; unlike the caption, it summarizes the image's appearance. It should comport with Wikipedia:Manual of Style/Accessibility/Alternative text for images and should name famous events, people and things.
  • A [[Siberian Husky]] used as a pack animal The caption comes last, and gives the meaning or significance of the image.

See WP:Extended image syntax for further features and options. If the image does not display after you have carefully checked the syntax, it may have been blacklisted.

VR photographs

To display VR photographs (a.k.a. 360-degree panoramas or photospheres), use {{PanoViewer}}.

Size

  • Images adjacent to text should use the thumb (thumbnail) or frameless parameter, typically sized differently from the original.[d] The default image width then becomes 250 pixels (px), which registered (logged-in) users can change via Preferences.[nb 2] The Siberian Husky image above is displayed at whatever your base width is.
Image using width |upright=1.6, so that it is 80% wider than the Siberian Husky image above (which is at the default |upright=1 width)
Image using |upright=0.5; a scaling factor less than 1 contracts the image width.
  • An image's size is controlled by changing its width – after which software automatically adjusts height in proportion. (Most references to an image's "size" really mean its width.)
  • Except with very good reason, a fixed width in pixels (e.g. 17px) should not be specified, because it ignores the user's base width setting. Thus |upright=scaling factor is preferred when it is desired to present an image at other than the default width.[nb 3] As a general rule, images should not be set to a larger fixed width than 250px (the initial base width), and if an exception to this general rule is warranted, the resulting image should usually be no more than 400px wide (300px for lead images) and 500px tall, for comfortable display on the smallest devices "in common use" (though this may still cause viewing difficulties on some unusual displays).
  • To convert a px value to upright, divide it by 250 and round the result as desired. For example, |150px is roughly equivalent to |upright=0.6 because 150 / 250 = 0.6.
    • Cases where fixed sizes may be used include for standardization of size via templates (such as within infobox templates or the display of country flag icons), for displaying reduced images sizes where space is constrained (such as images used in the In the News and Did You Know sections on the WP:Main Page, or within larger tables such as List of Nobel Peace Prize laureates), or if it is necessary to align images in columns or rows. Templates like {{multiple image}} can automatically match the height or width of images with different aspect ratios, though this height or width must be hard coded to a set number of pixels because it cannot scale images to respect users' preferences.
  • Where a smaller or larger image is appropriate, use |upright=scaling factor, which expands or contracts the image by a factor relative to the user's base width.
    • For example:
      • |upright=1.15 might be used for an image with fine detail (e.g. a map or diagram) to render it "15% wider than this user generally wants". (For a reader with the usual base width setting of 250px, this is 287px.)
      • |upright=0.6 might be used for an image with little detail (e.g. a simple drawing or flag) which can be adequately displayed "60% of the width this user generally wants". (For a reader with the usual base width setting of 250px, this is 150px.)
    • Short, wide images often call for |upright= of 1 or greater; tall, narrow images may look best with |upright= of 1 or less.
    • When specifying |upright= values greater than 1, take care to balance the need to reveal detail against the danger of overwhelming surrounding article text.
      • Images in which a small region of detail is important (but cropping to that region is unacceptable) may need to be larger than normal, but |upright=1.6 should usually be the largest value for images floated beside text.
      • Lead images should usually use |upright=1.2 at most.
    • Images within an article, especially those near one another and on the same side, may be more appealing if presented at the same width.
    • If upright is completely absent, that's equivalent to |upright=1. Just |upright alone, with no scaling factor (e.g. [[File:Dog.jpg|thumb|upright|A big dog]]) is equivalent to |upright=0.75; this usage is confusing and therefore deprecated. Historically, |upright was intended for upright (portrait) images, which look better at a narrower width. Later, the parameter was expanded to support any scaling factor, but the original name remained.
  • To present images larger than the guidelines above (e.g. panoramas), use |thumb|center or |thumb|none, so that the image stands alone; or use {{wide image}} or {{tall image}} to present a very large image in a scrollable box.
This image uses |thumb|center|upright=2.5 to expand the image, center it, and clear the area on either side.

Location

A white dog in a harness playfully nuzzles a young boy
A Siberian Husky used as a pack animal

Most images should be on the right side of the page, which is the default placement.[nb 4] Left-aligned images may distort the layout of an article and make it harder to navigate. They can make lines of text jump to the left in the middle of a paragraph and may also disturb the layout of bulleted lists and similar structures that depend on visual uniformity, e.g. by pushing some items on such lists further inward. Hence, avoid left-aligned images whenever possible, and always near such structures. If an exception to the general rule is warranted, specify |left in the image link: [[File:Siberian Husky pho.jpg|thumb|left|alt=A white dog in a harness playfully nuzzles a young boy |A [[Siberian Husky]] used as a pack animal]].

An image should generally be placed in the most relevant article section; if this is not possible, try not to place an image too early, i.e., far ahead of the text discussing what the image illustrates, if this could puzzle the reader. The first image of a section should be placed below any hatnote (typically a navigational hatnote in the form of {{Main}}, {{Further}} and {{See also}} templates). Do not place an image at the end of the previous section as this will not be visible in the appropriate section on mobile devices. Only small inline images can be placed within a paragraph; a thumb image creates a paragraph break.