Help:Pictures

From Wikipedia, the free encyclopedia

This tutorial explains how to insert pictures into Wikipedia articles using wikitext. This is one of the most frequently asked questions. It describes options for specifying placement, alt text, captions, sizes and links, and contains advice about panoramas and avoiding image stackups. There is also a technical document describing the syntax and a simple guide for beginners. The same syntax is used regardless of whether a file is from Wikipedia or Wikimedia Commons.

If you need help uploading an image, or selecting a suitable image for an article, see the image use policy and the Manual of Style. Images on most websites are copyrighted and should not be uploaded; see the copyright policy. Please upload the highest resolution image possible, but keep the file size under 1,000 megabytes.

Before you add an image to an article, view the image's image description page to make sure its copyright status is clearly stated, preferably with one of the image copyright tags.

Infobox picture

If an article already has an infobox at the top right, then the usual place for the article's first picture is within the infobox. For guidance on the syntax for doing this, see Help:Infobox picture. In very brief summary, one hurdle that trips up many people when attempting to add an image to an infobox template is that most internally provide the wiki code that "wraps" the image. Accordingly, you do not usually add the brackets, number of pixels, and other code details you will learn about below, when placing an image in infoboxes – just the file name next to a field labeled | image =. Adding such extraneous code will cause many infoboxes to break. Also, be aware that some infoboxes require that the file's name be placed without the file/image namespace prefix. Thus, and for example, if File:Name.jpg does not work, try just Name.jpg.

Thumbnails

An existing English Wikipedia or Wikimedia Commons image can be inserted into a page with the basic wikitext [[File:...|thumb|Caption text]].[a] Using thumb generates a thumbnail picture, typically sized differently from the original image. For guidance on the caption text to associate with images, see Wikipedia:Manual of Style/Captions. Several options can affect a thumbnail's placement and size, described below.

On the left

By default a thumbnail is floated to the right of the page, with the text flowing around it. However, our first example specifies left. Just below the example you can see what the resulting picture looks like:

[[File:Wikipedesketch.png|thumb|left|alt=A cartoon centipede reads books and types on a laptop.|The Wikipede edits ''[[Myriapoda]]''.]]
A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

The above text gives the image file name "Wikipedesketch.png", the image type "thumb" and alignment "left", the alt text "A cartoon centipede reads books and types on a laptop.", and the caption "The Wikipede edits Myriapoda." A Wikipedia reader can click on the thumbnail, or on the small double-rectangle icon below it, to see the corresponding file page which will let the user see the image in its original size.

Although the above text may appear in multiple lines for formatting purposes, the actual image text is on one line, as it uses spaces without any line breaks. The [[ and the first | must be on the same line; other spaces and line breaks are ignored if they are next to | characters or just inside the brackets. Some parts of the image syntax, such as the alt=, do not allow spaces or line breaks, and the easiest way to get it right is to omit unnecessary spaces and line breaks.

Alt text is intended for visually impaired readers. Often the caption or article will describe the image adequately, and where this is the case you can write alt=caption or alt=see adjacent text. If additional alt text is added, it should be a succinct description that complies with the content policies; see WP:ALT for more information. Unlike alt text, a caption can contain Wiki markup like ''[[Myriapoda]]''. The caption text is placed underneath the picture.

Here is the same example again, this time in the context of some colored lorem ipsum dummy text with asterisks (*) showing where the image syntax appears in the text:

[[File:Wikipedesketch.png|thumb|left|alt=A cartoon centipede reads books and types on a laptop.|The Wikipede edits ''[[Myriapoda]]''.]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Avoid referring to images as being "on the left". Image placement is different for viewers of the mobile version of Wikipedia, and is meaningless to people having pages read to them by assistive software. Instead, use captions to identify images.

On the right

The default placement for a thumbnail is on the right:

[[File:Wikipedesketch.png|thumb|alt=A cartoon centipede reads books and types on a laptop.|The Wikipede edits ''[[Myriapoda]]''.]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Avoid referring to images as "being on the right". Image placement is different for viewers of the mobile version of Wikipedia, and is meaningless to people having pages read to them by assistive software. Instead, use captions to identify images.

Without flowing text

Although most thumbnails are combined with flowing text and are placed to the right or left, you can also place a thumbnail without text flowing around it. One way is to center it, using center or centre:

[[File:Wikipedesketch.png|thumb|center|alt=A cartoon centipede reads books and types on a laptop.|The Wikipede edits ''[[Myriapoda]]''.]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

You can also place the picture to the left, without flowing text, using none:

[[File:Wikipedesketch.png|thumb|none|alt=A cartoon centipede reads books and types on a laptop.|The Wikipede edits ''[[Myriapoda]]''.]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Thumbnail sizes

By default, thumbnail images on Wikipedia have a width of 220 pixels (px). This width is used by typical readers who have not logged in or who have not changed their preferences. You can set a different default width for yourself in My preferences under "Appearance » Files". The options are 120px, 150px, 180px, 200px, 220px, 250px, 300px, and 400px. Any image narrower than the preferred width is displayed at the narrower width.

Images beside the text should generally use a caption and the thumb (thumbnail) option; the default results in a display 220 pixels wide (170 pixels if the upright option is used), except for those logged-in users who have set a different default in their user preferences. In general, do not define the size of an image unless there is a good reason to do so. Some users have small screens or need to configure their systems to display large text; "forced" large thumbnails can leave little width for text, making reading difficult. In addition, forcing a "larger" image size at say 260px will actually make it smaller for those with a larger size set as preference.

Sometimes a picture may benefit from a size other than the default; see the image use policy for guidance.

  • Normally the size should be specified as a value relative to the user's preferred base size, using the |upright= parameter rather than pixel values.
  • Where size forcing is appropriate, larger images should generally be no more than 500 pixels tall and 400 pixels wide, so that they can comfortably be displayed on the smallest displays in common use.
  • Lead images should usually be no wider than 300px. That is equivalent to using upright=1.35 if the default thumbnail width is 220px (220 multiplied by 1.35 then rounded to the nearest multiple of 10 equals 300), but larger defaults in user preferences will result in proportionally larger images (340px if the default is 250px, 410px if the default is 300px, or 540px if the default is 400px).

Since the MediaWiki software dynamically scales inline images there is no technical reason to reduce file size via scaling or quality reduction when uploading images, although non-free images may require scaling due to copyright concerns (consult the non-free image resolution guidelines). Also, compressing PNGs may be useful, because PNG files can be safely resized without losing quality.

The default behavior can make a tall, thin picture come out too large. For example:

[[File:Amun.svg|thumb|alt=Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.|The Egyptian god Amun, portrayed before the Amarna period]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.
The Egyptian god Amun, portrayed before the Amarna period

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Fusce convallis, mauris imperdiet gravida bibendum, nisl turpis suscipit mauris, sed placerat ipsum urna sed risus. In convallis tellus a mauris. Curabitur non elit ut libero tristique sodales. Mauris a lacus. Donec mattis semper leo. In hac habitasse platea dictumst. Vivamus facilisis diam at odio. Mauris dictum, nisi eget consequat elementum, lacus ligula molestie metus, non feugiat orci magna ac sem. Donec turpis. Donec vitae metus. Morbi tristique neque eu mauris. Quisque gravida ipsum non sapien. Proin turpis lacus, scelerisque vitae, elementum at, lobortis ac, quam. Aliquam dictum eleifend risus. In hac habitasse platea dictumst. Etiam sit amet diam. Suspendisse odio. Suspendisse nunc. In semper bibendum libero.

Proin nonummy, lacus eget pulvinar lacinia, pede felis dignissim leo, vitae tristique magna lacus sit amet eros. Nullam ornare. Praesent odio ligula, dapibus sed, tincidunt eget, dictum ac, nibh. Nam quis lacus. Nunc eleifend molestie velit. Morbi lobortis quam eu velit. Donec euismod vestibulum massa. Donec non lectus. Aliquam commodo lacus sit amet nulla. Cras dignissim elit et augue. Nullam non diam. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. In hac habitasse platea dictumst. Aenean vestibulum. Sed lobortis elit quis lectus. Nunc sed lacus at augue bibendum dapibus.

Upright images

The upright option can help fix this by informing the Wikipedia layout system that the image should have a narrower width than usual:

[[File:Amun.svg|thumb|upright|alt=Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.|The Egyptian god Amun, portrayed before the Amarna period]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.
The Egyptian god Amun, portrayed before the Amarna period

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Fusce convallis, mauris imperdiet gravida bibendum, nisl turpis suscipit mauris, sed placerat ipsum urna sed risus. In convallis tellus a mauris. Curabitur non elit ut libero tristique sodales. Mauris a lacus. Donec mattis semper leo. In hac habitasse platea dictumst. Vivamus facilisis diam at odio. Mauris dictum, nisi eget consequat elementum, lacus ligula molestie metus, non feugiat orci magna ac sem. Donec turpis. Donec vitae metus. Morbi tristique neque eu mauris. Quisque gravida ipsum non sapien. Proin turpis lacus, scelerisque vitae, elementum at, lobortis ac, quam. Aliquam dictum eleifend risus. In hac habitasse platea dictumst. Etiam sit amet diam. Suspendisse odio. Suspendisse nunc. In semper bibendum libero.

Proin nonummy, lacus eget pulvinar lacinia, pede felis dignissim leo, vitae tristique magna lacus sit amet eros. Nullam ornare. Praesent odio ligula, dapibus sed, tincidunt eget, dictum ac, nibh. Nam quis lacus. Nunc eleifend molestie velit. Morbi lobortis quam eu velit. Donec euismod vestibulum massa. Donec non lectus. Aliquam commodo lacus sit amet nulla. Cras dignissim elit et augue. Nullam non diam. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. In hac habitasse platea dictumst. Aenean vestibulum. Sed lobortis elit quis lectus. Nunc sed lacus at augue bibendum dapibus.

The upright option normally creates an image that is about 75% of the width of the default. The exact width is computed by starting with the default thumbnail width, multiplying it by 0.75, and rounding to the nearest multiple of 10. Normally the default width is 220px so an upright image is 170px wide; changing one's default width within the range from 120px to 400px results in upright image widths ranging from 90px to 300px.

Shrinking upright images further

If the upright factor 0.75 is too large or too small, it can be specified explicitly. A factor of 1.0 uses the default thumbnail width, which is the same as not specifying upright at all with the thumb option; a factor less than or greater than 1.0 creates an image smaller or larger than the default. For example:

[[File:Amun.svg|thumb|upright=0.56|alt=Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.|The Egyptian god Amun, portrayed before the Amarna period]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.
The Egyptian god Amun, portrayed before the Amarna period

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Fusce convallis, mauris imperdiet gravida bibendum, nisl turpis suscipit mauris, sed placerat ipsum urna sed risus. In convallis tellus a mauris. Curabitur non elit ut libero tristique sodales. Mauris a lacus. Donec mattis semper leo. In hac habitasse platea dictumst. Vivamus facilisis diam at odio. Mauris dictum, nisi eget consequat elementum, lacus ligula molestie metus, non feugiat orci magna ac sem. Donec turpis. Donec vitae metus. Morbi tristique neque eu mauris. Quisque gravida ipsum non sapien. Proin turpis lacus, scelerisque vitae, elementum at, lobortis ac, quam. Aliquam dictum eleifend risus. In hac habitasse platea dictumst. Etiam sit amet diam. Suspendisse odio. Suspendisse nunc. In semper bibendum libero.

Short, wide images

Short, wide images sometimes benefit from upright factors greater than 1.0. Factors greater than about 2.5 can generate large images that cause problems with some browsers; for one way to handle wider images, see Panoramas below. For example:

[[File:Köppen-vereinfacht.svg|thumb|center|upright=2.0|alt=Map of the world. A tan band stretches from northern Africa through central China; most of Australia and parts of south Africa and the western Americas are also tan. Dark greens dominate the northern hemisphere. Lighter greens cover much land near the equator. Polar areas are white, the north fringed with light blue.|Macroclimates of the earth. Tans represent desert, dark greens humid continental, and light green tropical rainforest. Light blue and white represent tundra and ice cap.]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

Map of the world. A tan band stretches from northern Africa through central China; most of Australia and parts of south Africa and the western Americas are also tan. Dark greens dominate the northern hemisphere. Lighter greens cover much land near the equator. Polar areas are white, the north fringed with light blue.
Macroclimates of Earth. Tans represent desert, dark greens humid continental, and light green tropical rainforest. Light blue and white represent tundra and ice cap.

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Be careful not to overstretch images for which the original file is quite small (except with SVG images, see below). If the original file is 120 pixels wide, and it's stretched beyond that, the pixels making it up will start to be visible.

SVG images are an exception: Being vector images, they have no pixels, just instructions on how to draw the image that can be scaled up indefinitely, and the "image size" in the file description is arbitrary.

Width in pixels

You can also display an image of a specified width. Typically, if you specify a width in pixels, it should be at least 300px. Widths greater than about 550px may cause problems with some browsers, as stated above.

[[File:Köppen-vereinfacht.svg|thumb|center|400px|alt=Map of the world. A tan band stretches from northern Africa through central China; most of Australia and parts of south Africa and the western Americas are also tan. Dark greens dominate the northern hemisphere. Lighter greens cover much land near the equator. Polar areas are white, the north fringed with light blue.|Macroclimates of the earth. Tans represent desert, dark greens humid continental, and light green tropical rainforest. Light blue and white represent tundra and ice cap.]]
Map of the world. A tan band stretches from northern Africa through central China; most of Australia and parts of south Africa and the western Americas are also tan. Dark greens dominate the northern hemisphere. Lighter greens cover much land near the equator. Polar areas are white, the north fringed with light blue.
Macroclimates of the earth. Tans represent desert, dark greens humid continental, and light green tropical rainforest. Light blue and white represent tundra and ice cap.

Height in pixels

To specify the exact height of a picture, letting the width scale to match, prefix the height with x. The following example resizes the image to a height of 60px:

[[File:Flag of Scotland.svg|thumb|center|x60px|alt=White diagonal cross over blue background|Flag of Scotland]]
White diagonal cross over blue background
Flag of Scotland

Width or height in pixels, whichever makes the image smaller

If you specify both width and height of a picture, it is sized to whichever value would make it smaller. This will cause a picture to fit in a certain area, regardless of the image's actual size. Since the proportions of File:Flag of Scotland.svg are 5×3, specifying a width of 120px generates a 120×72px image, and specifying a height of 60px generates a 100×60px image, so a size field of 120x60px generates the smaller of the two, namely, the 100×60px image:

[[File:Flag of Scotland.svg|thumb|center|120x60px|alt=White diagonal cross over blue background|Flag of Scotland]]
White diagonal cross over blue background
Flag of Scotland

Pixel counts vs. upright factors

Despite its name, the parameter "upright" is now used for both tall and wide images. Although pixel counts are easier to understand than upright factors, they adjust less well to user preferences. For example, suppose a picture contains some detail and by default is a bit too small, and you want to increase it by about 10%. Although upright=1.1 and 240px do the job equally well for the common case where the default width is 220 pixels, many of the users who set the default width to 300 pixels to work better with their high-resolution screens will be annoyed with 200px because it will make the picture a third smaller than their preferred size. In contrast, upright=1.1 will display the picture to them with a width of 330 pixels, and this is more likely to work well on their displays.

To clarify, "upright=0.75" is equivalent to "upright", and "upright=1" leaves the image at its default size (220px when not logged in), equivalent to not using "upright" at all. For convenience, a few conversions are as follows:

upright
scale
px size
(default)
0.2 40px
0.25 60px
0.5 110px
170px
0.75
1 220px
(not used)
1.25 280
1.35 300
1.5 330
1.8 400
2 440
2.25 500
2.5 550

Pixel counts are typically better than upright factors for displaying combinations of pictures, some of which have known and limited sizes, and for displaying tiny icons that are intended to be combined with text.

Native size

Replacing thumb with frame causes the image to be displayed in its native size, that is, the size that it was originally uploaded with. This use is obsolete and should not be used because it is disruptive for many displays, especially mobile devices. Instead, if an article would be better with pictures resized in some way other than the default, use the "upright" parameter. Users should set their own preferences if they want pictures resized and article authors should not do this. If anyone has a justification for using the frame feature then please share on the talk page. For historical reference, here is an example of it being used:

[[File:Wikipedesketch.png|frame|center|alt=A cartoon centipede reads books and types on a laptop.|The Wikipede edits ''[[Myriapoda]]''.]]
A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

Panoramas

Very large pictures should not be put directly into articles, as they cause problems in some browser environments. Images wider than 550px or so are often better treated as a panorama, which can be created with the {{Wide image}} template. For example:

{{wide image|Helsinki z00.jpg|1800px|alt=Panorama of city with mixture of five- to ten-story buildings|[[Helsinki]] has many buildings.}}
Panorama of city with mixture of five- to ten-story buildings
Helsinki has many buildings.

DjVu and PDF files

By Thomas Crane
This is page 2

Images can be excerpted from DjVu or PDF files, with an optional page parameter. For example:

[[File:Abroad - 1882.djvu|thumb|right|150px|By Thomas Crane|page=13]]
[[File:Cinderella (1865).pdf|thumb|left|150px|This is page 2|page=2]]

Avoiding stack-ups

One of the problems many users of floating pictures hit is that multiple pictures sometimes stack up vertically, particularly with large screens and wide images. For example, in many browsers the two pictures at the right of this text stack up awkwardly.

A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.
White diagonal cross over blue background
Flag of Scotland

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Often the best solution to this is simply to add more text, as is done below, but this sometimes is not possible. The following subsections show some other possible solutions to the problem.

A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Fusce convallis, mauris imperdiet gravida bibendum, nisl turpis suscipit mauris, sed placerat ipsum urna sed risus. In convallis tellus a mauris. Curabitur non elit ut libero tristique sodales. Mauris a lacus. Donec mattis semper leo. In hac habitasse platea dictumst. Vivamus facilisis diam at odio. Mauris dictum, nisi eget consequat elementum, lacus ligula molestie metus, non feugiat orci magna ac sem. Donec turpis. Donec vitae metus. Morbi tristique neque eu mauris. Quisque gravida ipsum non sapien. Proin turpis lacus, scelerisque vitae, elementum at, lobortis ac, quam. Aliquam dictum eleifend risus. In hac habitasse platea dictumst. Etiam sit amet diam. Suspendisse odio. Suspendisse nunc. In semper bibendum libero.

White diagonal cross over blue background
Flag of Scotland

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Alternating left and right

Perhaps the easiest way to handle multiple floating pictures is to alternate them left then right (or right then left); this way they do not come into contact with one another, and so cannot stack up in an unattractive way. This has a disadvantage, though: people with very low screen resolutions (such as those using netbooks) may find the result too awkward, albeit still readable.

A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

White diagonal cross over blue background
Flag of Scotland

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Co-aligning

It is common to have two pictures that logically should be grouped together. The {{multiple image}} template is one way to do this. For example:

Yellow cartouche
Caution
Red cartouche
Ejection
Two cards used by football referees
{{multiple image
 | width = 80
 | footer = Two cards used by football referees
 | image1 = Yellow card.svg
 | alt1 = Yellow cartouche
 | caption1 = Caution
 | image2 = Red card.svg
 | alt2 = Red cartouche
 | caption2 = Ejection
}}

The same template can also align pictures vertically:

Yellow cartouche
Caution
Red cartouche
Ejection
Two cards used by football referees
{{multiple image
 | direction = vertical
 | width = 80
 | footer = Two cards used by football referees
 | image1 = Yellow card.svg
 | alt1 = Yellow cartouche
 | caption1 = Caution
 | image2 = Red card.svg
 | alt2 = Red cartouche
 | caption2 = Ejection
}}

Galleries

A gallery displays several pictures in an array or similar layout. Before making a gallery, read the image use policy for galleries. Generally, a gallery should not be added so long as there is space for images to be effectively presented adjacent to text.

Technically, a gallery can be produced in different ways. One simple and flexible method is table syntax. For example:

{|style="margin: 0 auto;"
| [[File:Philipp Veit 008.jpg|thumb|upright|alt=Robed woman, seated, with sword on her lap|Philipp Veit, ''Germania'', 1834–36]]
| [[File:Image Germania (painting).jpg|thumb|upright|alt=Robed woman, standing, holding a sword|Philipp Veit, ''Germania'', 1848]]
| [[File:Niederwald memorial 2.JPG|thumb|upright|alt=Monument of robed woman, standing, holding a crown in one hand and a partly sheathed sword in another|Johannes Schilling, ''Germania'', 1871–83]]
|}
Robed woman, seated, with sword on her lap
Philipp Veit, Germania, 1834–36
Robed woman, standing, holding a sword
Philipp Veit, Germania, 1848
Monument of robed woman, standing, holding a crown in one hand and a partly sheathed sword in another
Johannes Schilling, Germania, 1871–83

Another simple way is the specialized <gallery> tag, which works like this:

<gallery>
File:Wiki.png|Caption 1
File:Wiki.png|Caption 2
</gallery>

Which produces:

You can also specify alt text and other image rendering parameters like page number for pdfs:

<gallery>
William Blake, a critical essay (Swinburne).pdf|Book by [[Algernon Charles Swinburne]]|alt=Page 1 of William Blake, a critical essay
William Blake, a critical essay (Swinburne).pdf|alt=Page 2 of William Blake, a critical essay|page=2
</gallery>

Which produces:

The gallery tag also offers some parameters, such as widths, heights and mode among others. The full documentation is available at mw:Help:Images#Gallery syntax. For example:

<gallery mode="packed-hover" heights="180">
File:Galerella sanguinea Zoo Praha 2011-2.jpg|''[[Galerella sanguinea]]'' (Slender Mongoose) 
File:Felis silvestris silvestris.jpg|''[[Felis silvestris|Felis silvestris silvestris]]''
File:Six weeks old cat (aka).jpg|''[[Felis silvestris catus]]'' (A Young Cat)
File:Felis catus-cat on snow.jpg|''[[Felis catus]]'' (cat on snow)
File:Tired 20-year-old cat.jpg|''[[Felis silvestris catus]]'' (Tired 20-year-old cat)
File:Cat November 2010-1a.jpg|''[[Felis silvestris catus]]'' (Cat)
File:Felis silvestris silvestris Luc Viatour.jpg|''[[Felis silvestris silvestris]]'' (European wildcat)
File:June odd-eyed-cat cropped.jpg|''[[Felis catus]]'' (Domestic cat)
File:Lynx kitten.jpg|''[[Lynx lynx]]'' (A Young Lynx)
</gallery>

produces:


The {{Gallery}} template offers a third method:

{{Gallery
|title=Cultural depictions of George Washington
|width=160
|height=170
|align=center
|File:Federal Hall NYC 27.JPG|alt1=Back of statue facing a city building whose facade is Greek columns covered by a huge U.S. flag|The statue of Washington outside [[Federal Hall]] in [[New York City]], looking on [[Wall Street]].
|File:Mount Rushmore2.jpg|alt2=Profile of stone face jutting out from a mountainside. Three workers clamber over it, each about the height of the face's upper lip.|Construction on the George Washington portrait at [[Mount Rushmore]], c. 1932.
|File:2014 ATB Quarter Obv.png|alt3=Silver coin with profile of Washington bust. He faces left regally and wears a colonial-style queue in his hair. "UNITED STATES OF AMERICA" is at top, "QUARTER DOLLAR" at bottom, "LIBERTY" at left, and "IN GOD WE TRUST" above "P" at right. Just below the bust is "JF uc" in tiny letters.|Washington is commemorated on the [[Quarter (United States coin)|quarter]].
|File:George Washington Presidential $1 Coin obverse.png|alt4=Gold coin with bust of Washington facing slightly left of but looking sternly straight at the viewer. "GEORGE WASHINGTON" is above, "1st PRESIDENT 1789–1797" below, and "JFM" in tiny letters at the bust's base.|Washington is also commemorated on some [[dollar coin (United States)|dollar coins]].
}}

Forcing a break

As a final resort, you can force the browser to insert a break, making all text and pictures appear below the bottom of the first picture. This can produce rather unattractive gaps, particularly in the accompanying text. Remember that text will flow and wrap differently for other users, based on their chosen browser, screen resolution, default font size, accessibility options, number of toolbars and sidebars (such as instant messaging panes) and more. Do not force page design just so that it looks pretty on your display. Hack only where absolutely necessary. Wherever possible, just use the simplest logical page flow.

{{clear}}
A cartoon centipede reads books and types on a laptop.
The Wikipede edits Myriapoda.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

White diagonal cross over blue background
Flag of Scotland

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Plain pictures

Most pictures in articles are thumbnails, but sometimes more specialized needs require finer grained control. A plain picture with no formatting can be inserted with:

[[File:Wikipedesketch.png|A cartoon centipede reads books and types on a laptop.]]

In this plain picture the text A cartoon centipede reads books and types on a laptop. is not visible as a caption. Instead, it appears as the title text of the image, commonly displayed as a tooltip during a mouseover. In a thumbnail the alt text defaults to empty, but a plain picture's alt text defaults to its title text if given and to the picture's file name if not; this default can be overridden with an explicit alt=Alt text option. Title text, like alt text, will ignore any Wiki markup.

A plain picture can be placed anywhere in the article, and acts as a big character in the text, so that nearby text does not float or wrap around it. For example:

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*A cartoon centipede reads books and types on a laptop.*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

  • Note: To achieve a plain image with a caption, one can use {{Plain image with caption}}. The caption is automatically added as the image's title and alt text, and any wiki markup used on it will be correctly displayed on the caption, but will be automatically stripped down from the alt and title text. See an example here.

Plain picture sizes

A plain picture defaults to the image's native size. This can be overridden with an explicit size. For example:

[[File:Wikipedesketch.png|50px|A cartoon centipede reads books and types on a laptop.]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*A cartoon centipede reads books and types on a laptop.*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

The frameless option causes a plain picture to default to the same size as a thumbnail. As with thumbnails, the default can be adjusted with the upright=factor option. If you use the common default of 220 pixels for thumbnail widths, the following example image's width will be 220 × 0.2 pixels, which rounds to 40 pixels:

[[File:Amun.svg|frameless|upright=0.2|alt=Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.|The Egyptian god Amun, portrayed before the Amarna period]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*Full-length profile of man in ancient Egyptian clothing. He has red-brown skin and wears a helmet with tall yellow plumes.*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Border

The border option adds a one-pixel border, which can be useful when it is important to distinguish image from background. Here is the same picture with and without a border.

[[File:Flag of Japan.svg|border|30px|White flag containing solid red circle]]
[[File:Flag of Japan.svg|30px|White flag containing solid red circle]]

This generates "White flag containing solid red circle White flag containing solid red circle".

Horizontal placement

Like thumbnails, plain pictures can be floated left or right with text flowing around them; or centered or put left without text flow. The only difference is that the right parameter is required to float a plain picture to the right, whereas floating right is the default for thumbnails. For example:

[[File:Wikipedesketch.png|right|A cartoon centipede reads books and types on a laptop.]]

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

*

A cartoon centipede reads books and types on a laptop.
A cartoon centipede reads books and types on a laptop.

*

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Vertical alignment

When a plain picture appears in text, it is aligned so that its vertical middle is roughly where the center of a lower-case "x" would be; if the image is larger than the line is tall, it sticks out both above and below. The vertical alignment syntax provides several options to adjust this. For example, the baseline option:

x[[File:Flag of Hungary vertical.svg|baseline|8px|Vertical version of horizontal tricolor flag (red, white, green)]]x

generates "xVertical version of horizontal tricolor flag (red, white, green)x" instead of the default "xVertical version of horizontal tricolor flag (red, white, green)x". Available options for vertical alignment, next to the output that they generate, are baselineVertical version of horizontal tricolor flag (red, white, green), middleVertical version of horizontal tricolor flag (red, white, green) (the default), subVertical version of horizontal tricolor flag (red, white, green), superVertical version of horizontal tricolor flag (red, white, green), text-topVertical version of horizontal tricolor flag (red, white, green), text-bottomVertical version of horizontal tricolor flag (red, white, green), topVertical version of horizontal tricolor flag (red, white, green), and bottomVertical version of horizontal tricolor flag (red, white, green).

Links

You may be looking for inline linking to external images. This is not allowed; see the Wikipedia Manual of Style on inline linking.

Normally a picture links to its image page, which describes the image, who created it, and links to the original image at full resolution. This is usually best for the reader, and is often required by the uploader's choice of a CC-BY-SA license for the image.

If the image is in the public domain, not requiring attribution to the uploader, you can create a plain picture that links to some other location by using the link option.

To link to some other page, specify its name in the link option along with an appropriate caption that hints to readers what will happen if they click on the link. This caption serves both as title text for the tooltip, and as alt text for visually disabled readers. For example, [[File:Flag of France.svg|20px|link=France|France]] generates a flag France that links to the article France.

To link to an external site, specify its URL in the link option along with an appropriate caption. For example, [[File:Flag of Belgium.svg|20px|link=http://www.belgium.be/en/|Belgium government portal]] generates a flag Belgium government portal that links to the English-language portal of the Belgian government.

To link to another Wikimedia site, use the site abbreviation. For example, [[File:Orcus symbol.svg|20px|link=wikt:🝿]] generates , which links to the (English) Wiktionary entry for that symbol.

A purely decorative image, which conveys no information and does nothing when it is clicked on, can be specified with an empty alt attribute. For example, [[File:Flag of the United States.svg|20px|link=|alt=]] generates a flag that is purely decorative. However, purely decorative files are only legally usable in this way if they are in the Public Domain or comply with WP:NFCC.

Image maps

1896 Democratic campaign poster with nominees William J. Bryan of Nebraska for President and Arthur Sewall of Maine for Vice PresidentWilliam J. BryanArthur Sewall

You can link different parts of an image to different locations using an image map. For example, in the image at right, clicking a circle roughly corresponding to the left portrait takes the reader to William Jennings Bryan, clicking the right portrait goes to Arthur Sewall, and clicking anywhere else goes to http://projects.vassar.edu/1896/democrats.html. This image is generated by the following markup:

<imagemap>
File:Bryan-Sewall.jpg|300px|right|alt=1896 Democratic campaign poster with nominees William J. Bryan of Nebraska for President and Arthur Sewall of Maine for Vice President
circle 950 850 700 [[William Jennings Bryan|William J. Bryan]]
circle 2950 850 700 [[Arthur Sewall]]
default [http://projects.vassar.edu/1896/democrats.html 1896 Democrats]
</imagemap>

This imagemap markup specifies that the title text (tooltips) for the three regions are "William J. Bryan", "Arthur Sewall", and "1896 Democrats", respectively. The alt text for an imagemap region is always the same as its title text; the alt text for the overall image is given in the first line of the imagemap's markup. The underlying image's native dimensions are 3916×1980, and the coordinates are given in these dimensions rather than in the 300px resizing. As described in the image map documentation, regions can be specified as circles, rectangles, and arbitrary polygons, and the blue "i" icon can be moved or suppressed. Also, the image can be specified as a thumb or frame, which means it has alt text and a caption in the usual way, with a double-rectangle icon instead of the blue "i" icon .


To do this easily, you can use a Commons gadget, called ImageMapEdit, by Dario D. Müller (ImageMapEdit_Howto). To use it, first you must enable ImageMapEdit (by clicking the check box) on the Preferences widget page (which is at the end of the second group of gadgets).

Then below a Commons image appears the ImageMapEdit > link, which activates the widget.

Let's look at the example of an eye, in which we will select the area of the cornea with a circle:

Selecting the area of the cornea of an eye


Copy the contents of Generated wikicode, on the clipboard. With Edit (source), paste the clipboard contents in the article (occasionally a template, and in this case: in this help) of Wikipedia, as appropriate.

<imagemap>
File:Eagle(owl)-eye.JPG|

circle 1028 717 299 [[Cornea]]

desc bottom-left
</imagemap>

Add in the code (<imagemap> ...) of the image (already copied in the article) the width that you think is appropriate (in this case we have chosen 250px) in the line of the file name, as shown:

<imagemap>
File:Eagle(owl)-eye.JPG|250px

circle 1028 717 299 [[Cornea]]

desc bottom-left
</imagemap>

The result will be:

Cornea

Try moving the mouse cursor over the cornea.


ImageMap is not enabled to contain a footer, for this reason we must include the above code in a table. For example:

{|class="wikitable" width="256" align=left 
|<imagemap>
File:Eagle(owl)-eye.JPG|250px
circle 1028 717 299 [[Cornea]]
desc bottom-left
</imagemap>
|-
| Click the cornea {{small|(indicated by the mouse cursor)}} on the image of the eagle-owl eye.
|}
{{-}}
Cornea
Click the cornea (indicated by the mouse cursor) on the image of the eagle-owl eye.

Overlaying annotations on an image

Some diagrams are uploaded without text, so that they can be used in multiple languages; or one may desire to add clickable links to an image. In such cases, text annotations can be added to an image with the templates Template:Annotated image or Template:Annotated image 4.

These templates allow wikitext (e.g., regular text, wikilinks, and reference templates) to be included on the image itself. They may also be used to crop an image so as to focus on a particular portion of it, or alternatively, expand the white area around an image for better placement of wikitext.

Annotated image template examples
Dorsal
Upper lateral
Lower lateral
Ventro-lateral
       = Frontal
Example of an annotated diagram (using Template:Annotated image) that has clickable wikilinks and overlaid text
Dorsal
Upper lateral
Lower lateral
Ventro-lateral
       = Frontal
The image above contains clickable links
Example of an annotated diagram (using Template:Annotated image 4) that has clickable wikilinks and overlaid text
The image and caption as a thumb, sans annotations

Linking without displaying

Let us say you want to link to the picture without displaying it. You can do it by adding a colon before the "File:" prefix. You can take them to the image page, where it tells them who uploaded it, when, what the copyright status is, etc.:

[[:File:Wikipedesketch.png]]
File:Wikipedesketch.png

You can make the link say anything you want.

[[:File:Wikipedesketch.png|A cartoon centipede reads books and types on a laptop.]]
A cartoon centipede reads books and types on a laptop.

When the link is clicked the image is displayed with other text information at a reasonable size. The user can click through the resulting medium-sized image to get to the full size highest resolution image.

You can also send the user directly to the image:

[[Media:Wikipedesketch.png]]
Media:Wikipedesketch.png

This says Media: instead of File:. When the user clicks on the link, the browser goes directly to the image. As before, you can change the text so it says anything you want.

[[Media:Wikipedesketch.png|A cartoon centipede reads books and types on a laptop.]]
A cartoon centipede reads books and types on a laptop.

This can be awkward if the image is quite large, for the full size image will be displayed when the user clicks the link.

Finally, you can link to one image from a thumbnail's small double-rectangle icon , but display another image using "|thumb=Displayed image name". This is intended for the rare cases when the Wikipedia software that reduces images to thumbnails does a poor job, and you want to provide your own thumbnail. In the following example, the double-rectangle links to File:Anime stub 2.svg but the image displayed is File:Anime stub.png:

Head of cute girl, manga-style, with blue hair, big eyes and smile, and gray puzzle pieces below and around her hair
Putting the puzzle together
[[File:Anime stub 2.svg|thumb=Anime stub.png |alt=Head of cute girl, manga-style, with blue hair, big eyes and smile, and gray puzzle pieces below and around her hair |Putting the puzzle together]]

Image frames

Multiple images can be displayed in an image frame:

{{Image frame|width=200|content=[[File:PNG transparency demonstration 1.png|100px]][[File:White Stars 3.svg|100px]]
|caption=Example usage|link=Hello world|align=center}}
Example usage

They can also be cropped and stacked inside the frame:

Dew on grass Luc Viatour.jpg
Dew on grass Luc Viatour.jpg
Dew on grass Luc Viatour.jpg
Dew on grass Luc Viatour.jpg
Cropped images in a frame
{{Image frame|align=left|border=no|caption=Cropped images in a frame|content=
{{stack
|{{CSS image crop
|Image = Dew on grass Luc Viatour.jpg
|bSize = 400
|cWidth = 100
|cHeight = 100
|oTop = 180
|oLeft = 60
}}
|{{CSS image crop
|Image = Dew on grass Luc Viatour.jpg
|bSize = 400
|cWidth = 100
|cHeight = 100
|oTop = 180
|oLeft = 60
}}
}}
{{stack
|{{CSS image crop
|Image = Dew on grass Luc Viatour.jpg
|bSize = 400
|cWidth = 100
|cHeight = 100
|oTop = 180
|oLeft = 60
}}
|{{CSS image crop
|Image = Dew on grass Luc Viatour.jpg
|bSize = 400
|cWidth = 100
|cHeight = 100
|oTop = 180
|oLeft = 60
}}
}}
}}

In case an image will not render

If the image will not render, and instead the wikicode is shown in the article, it may have the following causes:

  • The image syntax is incomplete or incorrect.
  • The caption may have incomplete link tags, especially unpaired [[s and ]]s that become interpreted as image syntax
  • The previous image may have incorrect image syntax, especially an incomplete ]] at the end
  • The capitalization in the wikicode must be followed; thus if an image file is Image:Photo of Wikipede.JPG, you will need to use the capital letters for "JPG".
  • The image is blacklisted on MediaWiki:Bad image list. Consider requesting its removal at MediaWiki talk:Bad image list.

Tips

  • When placing or sizing images, it is often better to edit the entire page, rather than just one section, to avoid unexpected overlaps with other sections of the article.
  • Before publishing any images, keep in mind that they can contain hidden data. This data can include comments that are not displayed, Exif metadata, and messages hidden via steganography.
  • Images can be rotated, mirrored, scaled and cropped using the templates {{Transform-rotate}}, {{MirrorH}}, {{CSS image crop}}.

See also

A Wikimedia Foundation brochure in PDF form that introduces newcomers to Wikimedia Commons and how they can contribute to it.

Notes

  1. ^ File: can be replaced with Image: with no change in effect; the choice between the two is purely a matter of editorial preference.