View source for Help:Images

[[File:Annotated file page.png|right|300px|thumb|The most important elements of an article in the "File" namespace.  See: [[Help:Files]] and [[Help:How to upload new versions of files]] for more information.]]
[[File:Adding an image to an article.mp4|600px|right]]
[[File:Pointer to file upload location.png|thumb|right|300px|To learn how to upload a new version of a file that is already in Saintapedia, see: [[Help:How to upload new versions of files]]]]

<section begin="intro" />'''Images''' are one type of file [[Help:File|that can be uploaded to Saintapedia]] and then added to pages by [[Special:Upload|uploading]] graphic files into [[Saintapedia]].  Once uploaded, these images are an article just like any other article in Saintapedia except they are stored in the File [[namespace]]. Once uploaded, users can edit the articles and add narrative further describing the images.

The most important thing to remember when uploading images to select a name that is descriptive and unique because all uploaded documents reside in the same file drawer.  Ask yourself the following question when thinking about the file name:
<blockquote>If I knew nothing about this file and came across it in three years, would it be reasonably clear from the filename what this image was?</blockquote> <section end="intro" /> {{Comment|{{#lst:Help:Images|intro}}}}

Saintapedia also allows users to [[Help:How to upload new versions of files|upload new versions]] of images and retain version control so it is almost never appropriate to include a specific date in the title.   Use the body of the article to describe the image in greater detail.  

Files can (and should) add categories to help further bin the image other similar groups of images.   If nothing else, add the [[:Category:Images|Images category]] if it is an image.  To do so, put the following wikitext at the end of the article:  <nowiki>[[Category:Images]]</nowiki>.  

Wikipedia has a tremendous wealth of information about how to use images.  Several of the key pages include:
* [[Wikipedia:Help:Images_and_other_uploaded_files|Wikipedia's help with files]]
* [[Wikipedia:Wikipedia:Picture_tutorial|a picture tutorial]] on Wikipedia

==Image file types ==
Saintapedia is agnostic about the type of file type to use for your images. As of May 2021, Saintapedia accepts png, gif, jpg, jpeg, and svg.  Note that Saintapedia sometimes does not render scaled images from GIF files very clearly. JPG/JPEG or PNG formats may give better results.

== Adding image ==
Both editors have the ability to add images without leaving the article you wish to place an image.  Images previously uploaded can always be added to any page on the wiki.

=== VisualEditor toolbar ===
{{#lsth:Help:Visual editor|Adding an image}}

=== Enhanced editor toolbar ===
[[File:Saintapedia advanced toolbar.png|600px|thumbnail|right|Advanced editing toolbar|alt=Screenshot of the Editing toolbar with the advanced buttons displayed]]
The image file must first be uploaded to Saintapedia.  A [[file page]] will be created once you upload it.  Immediately below explains how to display an image (or PDF) using the [[Editing Toolbar]] (call a [[File link]]).  For more options see [[Help:Images#Image syntax|Image syntax]] and [[Help:Images#Detailed syntax|Detailed syntax]] (Advanced).

# Place the cursor where you wish the file to appear
# Click the "Insert an image" icon ([[File:Saintapedia editing toolbar image icon.png|alt=Insert image icon on the editing toolbar|30x30px]].  An Insert file box will open (see below).
# In the "Filename" add the title from the [[file page]]
# Add a caption to the photo (optional)
# Add a image size (optional); if left blank it will show the image in the size of the uploaded file
# Choose the alignment/location of the photo (Options - default, none, center, left, or right)
# Pick the [[Help:Images#Type|Image Type]] to set border and scaling (Options - thumbnail, framed, frameless, or none)
# Click on "Insert"
# Make sure to save the page.
When the page is displayed, the file will appear where it was inserted.  Please also add the [[Alt attribute#In Saintapedia|Alt attribute]] so that the content is [[Accessibility|accessible]] to those with disabilities (required by [[Section 508]]).

== VisualEditor ==
VisualEditor has the ability to modify many of the settings of uploaded images, including images uploaded during the current session or existing images on a page. See [[#VisualEditor toolbar|VisualEditor toolbar]] for more details.

=== Settings options in editors ===
{| class="wikitable"
! colspan="2" |VisualEditor
! rowspan="2" |Enhanced editor only
|-
!General settings
!Advanced settings
|-
|
* Caption
* Alternative text
|
* [[Help:Images#Location|Position]]
* Wrap text around this item
* [[Help:Images#Type|Image type]]
* [[Help:Images#Border|Border]]
* Image size
* Make full size
|
* [[Help:Images#Link|Link]]
* [[Help:Images#Vertical alignment|Vertical alignment]]
* [[Help:Images#Size|Advance size]] options
|}
[[File:Visual editor image dialog box.png|alt=Screenshot of Visual editor image dialog box|none|thumb|500x500px|Visual editor image dialog box|link=https://powerpedia.energy.gov/wiki/File:Visual_editor_image_dialog_box.png]]

== Enhanced editor ==
Below is a listing of all the options when using Enhanced editor ("Edit Source").  Most of these settings can be done using VisualEditor, but not all of them.  If it is not an option in VisualEditor, Enhanced editor will need to be used.
===Image syntax===
The following information aid on syntax for images was originally derived from [http://en.wikipedia.org/w/index.php?title=Wikipedia:Extended_image_syntax&oldid=377273086 this version] of Wikipedia's page: "Wikipedia:Extended image syntax"


:<code><nowiki>[[File:</nowiki></code>'''''Name'''''<code>|</code>'''''Type'''''<code>|</code>'''''Border'''''<code>|</code>'''''Location'''''<code>|</code>'''''Alignment'''''<code>|</code>'''''Size'''''<code>|link=</code>'''''Link'''''<code>|alt=</code>'''''Alt'''''<code>|</code>'''''Caption'''''<code>]]</code>

Only '''''Name''''' is required. Most images should use "<code><nowiki>[[Image:</nowiki></code>'''''Name'''''<code>|thumb|alt=</code>'''''Alt'''''<code>|</code>'''''Caption'''''<code>]]</code>" and should not specify a size. The other details are optional and can be placed in any order.

; {{Anchors|Type}}''Type'' : "<code>thumb</code>" (or "<code>thumbnail</code>"; either can be followed by "<code>=<var>filename</var></code>"), "<code>frame</code>" (or "<code>framed</code>"), or "<code>frameless</code>". Display the image with specific formatting (see below).
; ''Border'' : "<code>border</code>". Put a small border around the image.
; ''Location'' : "<code>right</code>", "<code>left</code>", "<code>center</code>" or "<code>none</code>". Determine the horizontal placement of the image on the page. This defaults to "<code>right</code>" for thumbnails.
; ''Alignment'' : "<code>baseline</code>", "<code>middle</code>", "<code>sub</code>", "<code>super</code>", "<code>text-top</code>", "<code>text-bottom</code>", "<code>top</code>", or "<code>bottom</code>". Vertically align the image with respect to adjacent text. This defaults to "<code>middle</code>".
; ''Size'' : "'''Width'''<code>px</code>" or "<code>x</code>'''Height'''<code>px</code>" or "'''Width'''<code>x</code>'''Height'''<code>px</code>" or "<code>upright</code>" or "<code>upright='''Factor'''</code>". Scale the image to be no greater than the given width and/or height, keeping its aspect ratio. With "<code>upright</code>", scale a thumbnail from its default size by the given factor (default 0.75), rounding the result to the nearest multiple of 10 pixels. Size is disabled when the image is 'framed'.
; ''Link'' : Link the image to a different resource, or to nothing. Must not be set for non-public domain images unless attribution is provided in some other fashion.
; ''Alt'' : Specify the [[alt attribute|alt text]] for the image. This is intended for visually impaired readers. See {{W|WP:ALT}} for how this typically should differ from the caption.
; ''Caption'' : Specify the image's caption.
; ''Page'': Specify a page number to view (for PDF files only)

It does not matter whether the file is from [[Wikimedia Commons]] or on Wikipedia; the same syntax is used.
{{Help Box}}

===Detailed syntax===
The image syntax begins with "<code><nowiki>[[</nowiki></code>", contains components separated by "<code>|</code>", and ends with "<code><nowiki>]]</nowiki></code>". The "<code><nowiki>[[</nowiki></code>" and the first "<code>|</code>" (or, if there is no "<code>|</code>", the terminating "<code><nowiki>]]</nowiki></code>") must be on the same line; other spaces and line breaks are ignored if they are next to "<code>|</code>" characters or just inside the brackets. Spaces or line breaks are not allowed just before the "<code>=</code>" in the following options, and may have undesirable side effects if they appear just after the "<code>=</code>".

====Type====
Zero or one of these options may be specified to control whether or not the image is scaled down and given a border.
; <code>thumb</code> : (Or '''<code>thumbnail</code>'''.) Scale the image down, and put a box around the image. Show any caption below the image. Place the image on the right unless overridden with the location attribute. If no image size is specified, use a per-user preference for logged-in users (see "Thumbnail size" under [[Special:Preferences]]/'''Appearance'''/'''Files'''), defaulting to 220 pixels for non-logged-in users. With an operand, ''e.g.'', "<code>thumb=Example.png</code>", the operand names an image that is used as the thumbnail, ignoring any size specification.
:Thumbnailing animated GIFs is not supported. Thumbnailing an animated GIF does not result in an error, so there is no warning, but the animated GIF is not processed. Instead the original animated GIF is shipped, and whether the animated GIF is subsequently scaled to fit the allotted space is down to the capabilities of the receiving browser.
; <code>frame</code> : Preserve the original image size, and put a box around the image. Show any caption below the image. Sizing does not work when "<code>frame</code>" is used.
; ''(nothing specified)'' : Preserve the original image size, and do not add a border around the image. Do not show a caption. If no alt text is specifically requested, use the requested caption as alt text.
; <code>frameless</code> : Like "<code>thumb</code>", but omit the visible caption and the box around the image. Another way to put it is that this is like specifying no type, except that the default size is that of a thumbnail and the "<code>upright</code>" option works.

==== Border ====
; <code>border</code> : Generate a one-pixel border around the image. This has an effect only around unframed images, as framed images always have borders.

====Location====
Zero or one of these options may be specified to control the position of the image.
; <code>right</code> : Place the image on the right side of the page. The article text that follows the image flows around the image. This is the default.
; <code>left</code> : Place the image on the left side of the page. The article text that follows the image flows around the image.
; <code>center</code> : Place the image in the center of the page. The article text that follows the image is placed below the image.
; <code>none</code> : Place the image on the left side of the page. The article text that follows the image is placed below the image.

====Vertical alignment====
Zero or one of these options may be specified to control the vertical alignment of the image with respect to adjacent text. These options apply only to plain images, which do not cause breaks and are not floated. In the following list, each option's explanation is preceded by what ''[[:Image:Flag of Hungary vertical.png]]'' looks like when aligned with that option, using the markup:
: <code><nowiki>[[Image:Flag of Hungary vertical.png|</nowiki>''option''<nowiki>|7px|link=|alt=]]</nowiki></code>

; <code>baseline</code>: [[Image:Flag of Hungary vertical.png|baseline|7px|link=|alt=]]Align the bottom of the image with the baseline of the text.

; middle: [[Image:Flag of Hungary vertical.png|middle|7px|link=|alt=]](This is the default.) Align the vertical middle of the image with the baseline of the text plus half the x-height of the text, so that the image is vertically centered around a lower case "x" in the text.

; sub: [[Image:Flag of Hungary vertical.png|sub|7px|link=|alt=]]Align the bottom of the image to the same level that the bottom of a subscript would be, such as the bottom of the "2" in "X<sub>2</sub>".

; super: [[Image:Flag of Hungary vertical.png|super|7px|link=|alt=]]Align the bottom of the image to the same level that the bottom of a superscript would be, such as the bottom of the "2" in "X<sup>2</sup>".

; text-top: [[Image:Flag of Hungary vertical.png|text-top|7px|link=|alt=]]Align the top of the image to the top of the text. This is often a bit higher than the top of a capital letter, because of ascenders in letters like lower-case "h".

; text-bottom: [[Image:Flag of Hungary vertical.png|text-bottom|7px|link=|alt=]]Align the bottom of the image to the bottom of the text. This is somewhat lower than the baseline, because of descenders in letters like lower-case "y".

; top: [[Image:Flag of Hungary vertical.png|top|7px|link=|alt=]]Align the top of the image to the top of the line containing the text. Normally this is slightly higher than the top of the text, to make space between lines of text.

; bottom: [[Image:Flag of Hungary vertical.png|bottom|7px|link=|alt=]]Align the bottom of the image to the bottom of the line containing the text. Normally this is slightly lower than the bottom of the text.

====Size====
Zero or one of these options may be specified to control the size of the image. In the case of images with captions, if the image is already smaller than the requested size, then the image retains its original size (it is not enlarged). In the case of images without captions, the image will be enlarged or reduced to match the requested size. Sizing is disabled when a 'frame' is used.

; ''Width''<code>px</code> : (''E.g.'', "<code>100px</code>".) Scale the image to make it the specified number of pixels in width, and scale the height to retain the original aspect ratio.
; <code>x</code>''Height''<code>px</code> : (''E.g.'', "<code>x150px</code>".) Scale the image to make it the specified number of pixels in height, and scale the width to retain the original aspect ratio.
; ''Width''<code>x</code>''Height''<code>px</code> : (''E.g.'', "<code>100x150px</code>".) Scale the image to be no wider and no higher than the specified number of pixels. The image will keep its original aspect ratio.
; ''(nothing specified)'' : For thumbnails, use the size specified in preferences for logged in users, and use a size determined by resolution for anonymous users. For non-thumbnails, use the native size of the image.
; <code>upright</code> : Scale a thumbnail image to 75% of normal thumbnail width, rounding the result to the nearest multiple of 10 pixels.
; <code>upright=</code>''Factor'' : Adjust a thumbnail's size to '''''Factor''''' times the default thumbnail size, rounding the result to the nearest multiple of 10. For instance, "<code>upright=1.5</code>" makes the image larger, which is useful for maps or schematics that need to be larger to be readable. The parameter "<code>upright=1</code>" returns the same size as thumbnail width, and "<code>upright=0.75</code>" is functionally identical to "<code>upright</code>" alone.

The "<code>upright</code>" option must be used along with the "<code>thumb</code>" parameter.

Resizing animated GIFs is not supported. Resizing an animated GIF does not result in an error, so there is no warning, but the animated GIF is not processed. Instead the original animated GIF is shipped, and whether the animated GIF is subsequently scaled to fit the allotted space is down to the capabilities of the receiving browser.

==== Basic example ====
Add a pipe (|) followed by the width in pixels (px), such as what you see below.  This works for both images (jpg, png, gif, etc.) as well as [[PDF]]s.

====Link====
Ordinarily, an image acts as a hypertext link to the [[Help:Image page|image description page]], a page with information about the image itself. Using the link option allows an image to act as a hypertext link to a different page. See [{{W|Wikipedia:Images linking to articles}} for more information.
; <code>link=</code>''Page'' : The image acts as a hypertext link to the specified page. Do not enclose the page name in square brackets. If '''''Page''''' is a URL, the image acts as an external link; otherwise it links to the named Wikipedia page.
; <code>link=</code> : No hyperlink is created. Clicking on the image will have no action.
The "<code>link</code>" parameter cannot be used in conjunction with "<code>thumb</code>", as "<code>thumb</code>" is always meant to link to the larger version of the image. In addition, "<code>link</code>" cannot be used with "<code>frame</code>".

If you do not want the image to be clickable, only add:
<code>link=</code> without the ''Page''

====Alt text and caption====
Zero or more of these options may be specified to control the ''alt text'', ''link title'', and ''caption'' for the image. Captions may contain embedded wiki markup, such as links or formatting. See [[Wikipedia:Captions]] for discussion of appropriate caption text. See [[Wikipedia:Alternative text for images]] for discussion of appropriate alt text. Internet Explorer displays the link title as a tooltip but other browsers may not.

; <code>alt=</code>''Alt'' : Use '''''Alt''''' as the alt text for the image.
; ''Caption'': (any text that is not recognised as some other part of the image syntax): How this text is used depends on the image type. When the type has a visible caption ("<code>thumbnail</code>", "<code>thumb</code>", "<code>frame</code>" or "<code>framed</code>") then this text appears as a caption below the image. Otherwise, (if the image type is unspecified or is "<code>frameless</code>"), this text is used for the link title provided the link has not been suppressed with "<code>|link=</code>", and also for the alt text provided an explicit <code>alt=</code>'''''Alt''''' has not been supplied.

The actual alt text for the displayed image will be one of the following, in order of preference:
# The explicitly requested '''''Alt''''', if any;
# The explicitly requested '''''Caption''''', if the image type has no visible caption;
# The empty string, if there is an explicitly requested '''''Caption''''' and the image type has a visible caption.
# The image file name if there is no explicitly requested '''''Alt''''' or '''''Caption'''''. This is never a satisfactory option.

It is only possible to specify the link title text for images with no visible caption (as described above). However, as not all browsers display this text, and it is ignored by screen readers, there is little point.

===How to display an image in uploaded size, with a caption===
To display an image as uploaded with a caption use <code><nowiki>[[Image:Westminstpalace.jpg|frame|none|alt=alt text|caption text]]</nowiki></code>.

[[Image:Westminstpalace.jpg|frame|none|alt=alt text|caption text]]

===How to display an image with no caption or formatting===
The old syntax for images without captions is <code><nowiki>[[Image:Westminstpalace.jpg|alt text]]</nowiki></code>. This is rendered inline, and the specified text is used as the image's ''alt'' attribute (alternate text for programs which cannot display images, such as [[screen reader]]s) and as the ''title'' attribute (supplementary text, often displayed as a tool tip when the mouse is over the image).

See [[Wikipedia:Image markup with HTML]] for an old, deprecated, way of putting a caption under the image using HTML code. Please use the new way of associating captions with images, as described on this page.

See [[Wikipedia:Captions]] for discussion of appropriate caption text. See [[Wikipedia:Alternative text for images]] for discussion of appropriate alt text.

====Example====
[[Image:Westminstpalace.jpg|alt text]]

===New syntax for images===
[[Image:Westminstpalace.jpg|thumb|100px|left|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]The new syntax is backward compatible, so articles don't have to be changed.
In the syntax <code><nowiki>[[</nowiki>Image:''filename''|''options''<nowiki>]]</nowiki></code> (''e.g.'', <code><nowiki>[[Image:Westminstpalace.jpg|thumb|100px|left|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]</nowiki></code> shown in the left), several options can be set when including an image. Those affect the placing of the image, its size or the way the image will be presented. The options are <code>right</code>, <code>left</code>, <code>center</code>, <code>none</code>, <code>''size''px</code>, <code>thumbnail</code> (<code>thumb</code>), <code>frame</code>, and <code>''alternate (caption) text''</code>.{{clr}}

[[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster|200px|right|From the Thames]]
* The options can be combined, and vertical bars ("|") are used to separate options from each other.
* Do not put spaces around the vertical bars for readability &ndash; options will not be interpreted correctly.
* The options can be put in any order.
* An unknown option is taken as the caption text, but this will appear only if <code>thumbnail</code> or <code>frame</code> are specified.
* If there are two or more unknown options, the last one upstages the rest: <code><nowiki>[[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster|200px|right|From the Thames]]</nowiki></code> (shown on the right).{{clr}}

Here is the description of the options other than the caption text:

====right====
[[Image:Westminstpalace.jpg|right|70px|alt=A large clock tower and other buildings line a great river.]]The image is right-aligned, and text floats to the left of the image: <code><nowiki>[[Image:Westminstpalace.jpg|right|70px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> (shown on the right).{{clr}}<hr>
====left====
[[Image:Westminstpalace.jpg|left|70px|alt=A large clock tower and other buildings line a great river.]]The image is left aligned, and text floats to the right of the image: <code><nowiki>[[Image:Westminstpalace.jpg|left|70px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> (shown on the left).{{clr}}<hr>
====center====
The image is centered, and...[[Image:Westminstpalace.jpg|center|70px|alt=A large clock tower and other buildings line a great river.]]the text following the image starts below it: <code><nowiki>[[Image:Westminstpalace.jpg|center|70px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> (shown above).{{clr}}<hr>
====none====
The image is put at the left, and...[[Image:Westminstpalace.jpg|none|70px|alt=A large clock tower and other buildings line a great river.]]the text following does not float to the right (or to the left, obviously), and starts below it: <code><nowiki>[[Image:Westminstpalace.jpg|none|70px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> (shown above).{{clr}}<hr>

:: '''Notes:'''{{clr}}
::[[Image:Westminstpalace.jpg|center|left|none|right|70px|alt=A large clock tower and other buildings line a great river.]]The above four options are incompatible. When used combined, the first one overrides the rest: <code><nowiki>[[Image:Westminstpalace.jpg|center|left|none|right|70px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> (shown in the center).{{clr}}

::[[Image:Westminstpalace.jpg|70px|alt=A large clock tower and other buildings line a great river.|right]]What is between the last vertical bar and the closing brackets ("]]"), void or not, is taken as the last option, and works as usual. For instance, when the last option is <code>right</code>, the image is right-aligned, and text floats to the left: <code><nowiki>[[Image:Westminstpalace.jpg|70px|alt=A large clock tower and other buildings line a great river.|right]]</nowiki></code> (shown on the right).{{clr}}

::[[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|This text is not displayed.|70px|left|]][[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|This text is displayed.|70px|right]]In particular, if the last option is the void text (that is, if there is nothing between the last vertical bar and the closing brackets), the caption is not displayed: <code><nowiki>[[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|This text is not displayed.|70px|left|]]</nowiki></code> (shown on the left) and <code><nowiki>[[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|This text is displayed.|70px|right]]</nowiki></code> (shown on the right).{{clr}}

; <code>''size''px</code> : [[Image:Westminstpalace.jpg|right|50px|alt=A large clock tower and other buildings line a great river.]]This option renders a version of the image that's ''[size]'' pixels wide (''e.g.'', <code><nowiki>[[Image:Westminstpalace.jpg|right|50px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> shown on the right). Height is computed to keep (i.e. the shape of the image){{clr}}

:: '''Notes:'''{{clr}}
::Specifying a size does not just change the apparent image size using HTML; it actually generates a resized version of the image on the fly and links to it appropriately. This happens whether or not you specify the size in conjunction with "<code>thumb</code>".

::This means the server does all the work of changing the image size, not the web browser of the user. By having the server do all the work means faster downloading of pages. It also means that larger images can be stored on the server without any slowdown by the browser (especially on dial up telephone lines.) Only the data for the actual size on the page is transmitted.

::An exception is animated GIF. Animated GIFs are not processed by the server. When a smaller size is specified the original full sized animated GIF is served. Whether the animated GIF is subsequently scaled to fit the allotted space is down to the capabilities of the receiving browser. Resizing an animated GIF will significantly reduce its quality, without any reduction of download time.

::From [[m:MediaWiki 1.5|MediaWiki 1.5]] the default thumbnail width can be set in the preferences, so it is recommended ''not'' to specify "px", in order to respect the users' preferences (unless, for a special reason, a specific size is required regardless of preferences, or a size is specified outside the range of widths 120–300px that can be set in the preferences).

:: If you specify a "frame" option the image will not be scaled, and no size specifiers will be in the HTML. The image will be rendered at full size{{clr}}

:: [[Image:Westminstpalace.jpg|right|80px|alt=A large clock tower and other buildings line a great river.]]When there are two or more "size" options, only the last one is valid: <code><nowiki>[[Image:Westminstpalace.jpg|right|50px|80px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> (shown on the right).{{clr}}

; <code>thumbnail</code>, <code>thumb</code> : [[Image:Westminstpalace.jpg|thumbnail|left|100px|alt=A large clock tower and other buildings line a great river.]][[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]The <code>thumbnail</code> (<code>thumb</code>) option generates a image. It is automatically resized when the "size" attribute is not specified. Without the options <code>left</code>, <code>center</code>, and <code>none</code>, the image is normally on the right. If the image has a caption text, it is displayed in the lower margin. ''E.g.'', <code><nowiki>[[Image:Westminstpalace.jpg|thumbnail|left|100px|alt=A large clock tower and other buildings line a great river.]]</nowiki></code> (shown on the left) and <code><nowiki>[[Image:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]</nowiki></code> (shown on the right). ''Note: thumbnail (thumb) cannot be used in lists.''
{{clr}}

<!-- The following paragraph is supposed to show how one can display a 10 by 10 pixel image as 100 by 100, and that clicking on "enlarge" actually shows it smaller (in the original size). But it doesn't seem to work--the image is displayed 10 by 10. -->
[[Image:tst.png|right|thumb|100px|This is a globe, and take a look at it in [[Special:FilePath/Tst.png|the actual size]].|link=Special:FilePath/Tst.png]]An "enlarge"-icon is put also in the lower margin of the thumbnail. Both the image itself and the icon link to the image description page with the image in its actual size. The icon shows the link title "Enlarge" in its hoverbox, even in cases where this term does not apply, because it leads from the enlarged image to the one with the actual size. ''E.g.'', <code><nowiki>[[Image:tst.png|right|thumb|100px|alt=tiny globe|This is a globe, and take a look at it in [[Media:tst.png|the actual size]].]]</nowiki></code> (shown on the right).{{clr}}

; <code>upright</code> : [[Image:Westminstpalace.jpg|thumbnail|upright|left|alt=A large clock tower and other buildings line a great river.|The "<code>upright</code>" option is about 75% of thumbnail width.]][[Image:Westminstpalace.jpg|thumb|upright=1.5|right|alt=A large clock tower and other buildings line a great river.|The "<code>upright=1.5</code>" option]]The <code>upright</code> option works in combination with the <code>thumbnail</code> or <code>thumb</code> option to resize an image to about 75% of the width of a plain <code>thumbnail</code>. The <code>upright</code> option scales larger or smaller in step with user screen resolution. The relative size can be determined with a multiplier such as <code>upright=''x''</code>. If ''x''=1 then the image is standard thumbnail width. ''E.g.'', <code><nowiki>[[Image:Westminstpalace.jpg|thumbnail|upright|left|alt=A large clock tower and other buildings line a great river.|The "<code>upright</code>" option is about 75% of thumbnail width.]]</nowiki></code> (shown on the left) and <code><nowiki>[[Image:Westminstpalace.jpg|thumb|upright=1.5|right|alt=A large clock tower and other buildings line a great river.|The "<code>upright=1.5</code>" option]]</nowiki></code> (shown on the right).
{{clr}}

; <code>frame</code> : [[Image:Westminstpalace.jpg|frame|thumbnail|50px|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]With this option, the embedded image is shown with its actual size enclosed by a frame, regardless of the "thumb" or "size" attribute, and the caption, if any, is visible in the frame. Without the options <code>left</code>, <code>center</code>, and <code>none</code>, the image is normally on the right: <code><nowiki>[[Image:Westminstpalace.jpg|frame|thumbnail|50px|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]</nowiki></code>.{{clr}}

With none of the options other than <code>''size''px</code> and <code>''alternate (caption) text''</code>, an embedded image is rendered inline.

<pre style="overflow:auto;">
text text text text text text
<nowiki>[[Image:Westminstpalace.jpg|150px|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]</nowiki>
text text text text text
<nowiki>[[Image:tst.png|100px|alt=tiny globe|This is a globe.]]</nowiki>
text text text text
</pre>

gives

text text text text text text
[[Image:Westminstpalace.jpg|150px|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]
text text text text text
[[Image:tst.png|100px|This is a globe.|link=Special:FilePath/Tst.png]]
text text text text

The option <code>none</code> can be used to have thumbnails without left- or right-alignment. This is probably most useful for [[Wikipedia:How to use tables|tables]]. This is an example:

{| class="wikitable"
! colspan="3" | How to use <code>none</code>
|-
! colspan="3" | London's palaces
|-
| Palace of Westminster || [[Image:Westminstpalace.jpg|thumb|none|100px|alt=A large clock tower and other buildings line a great river.|From the Thames]] || <code><nowiki>[[Image:Westminstpalace.jpg|thumb|none|100px|alt=A large clock tower and other buildings line a great river.|From the Thames]]</nowiki></code>
|-
| Palace of Westminster|| [[Image:Westminstpalace.jpg|thumb|none|100px|alt=grand city building below beautiful blue sky and clouds|Queen's home]] || <code><nowiki>[[Image:Westminstpalace.jpg|thumb|none|100px|alt=grand city building below beautiful blue sky and clouds|Queen's home]]</nowiki></code>
|}

===Thumbnail with caption text underneath that has one or more links===
From MediaWiki 1.3, it is also possible to include links in the caption text, ''e.g.'':

: <code><nowiki>[[Image:Westminstpalace.jpg|right|thumbnail|alt=A large clock tower and other buildings line a great river.|This is the [[Palace of Westminster]] in London]]</nowiki></code>

[[Image:Westminstpalace.jpg|right|thumbnail|alt=A large clock tower and other buildings line a great river.|This is the [[Palace of Westminster]] in London]]

<br style="clear:both;" />

Just make sure the number of opening and closing square brackets are right. One extra or missing would mean the entire image syntax line would not work.

===Additional caption formatting options===
Additional caption formatting options are possible.

: <code><nowiki>[[Image:Westminstpalace.jpg|right|thumbnail|alt=A large clock tower and other buildings line a great river.|<div align="center">This is <span style="color: green">the </span><br /> [[Palace of Westminster]]<br /> '''in <span style="color: red">London</span>'''</div>]] </nowiki></code>

[[Image:Westminstpalace.jpg|right|thumbnail|alt=A large clock tower and other buildings line a great river.|<div align="center">This is <span style="color: green">the </span><br /> [[Palace of Westminster]]<br /> '''in <span style="color: red">London</span>'''</div>]]

<br clear="right" />
All of the normal text formatting options work.

=== Compatibility considerations ===
The floating options ''left'', ''center'', and ''right'' explained above are supported by modern browsers, but don't work with older browsers. If necessary it's simple to get a floating effect also for old browsers:

{| align="right"
| [[Image:Westminstpalace.jpg|160px|alt=A large clock tower and other buildings line a great river.|Example]]
|}

<pre style="overflow:auto;">
{| align="right"
| [[Image:Westminstpalace.jpg|160px|alt=A large clock tower and other buildings line a great river.|Example]]
|}</pre>

This code is not intended for general use, however. There are few, if any, instances where support for such legacy browsers is necessary.

===Cancelling floating-around-image mode===<!-- This section is linked from [[George Fox]] -->
After having had an image floating next to text, putting further text below it and again using the full width can be done with the following markup. This blocks an image from appearing next to the material following this markup, possibly due to [[aesthetics|aesthetic]] reasons or a change in topics.

: <code><nowiki><br style="clear:both" /></nowiki></code>

For legacy <code>align="right"</code> (etc.) floating this
isn't good enough; legacy browsers would ignore inline
CSS. To cancel floating under all conditions the
following markup (valid XHTML 1.0 transitional) works:

: <code><nowiki><br clear="all" /></nowiki></code>

The same code can be issued by using template {{tl|clear}} or {{tl|Clr}} or {{tl|-}}
in certain namespaces (En, meta).

===Linking to the image description page===
If you want to make a link to the description page for an image, use a leading colon before "Image:" in an intra-wiki link, like this: <code><nowiki>[[:Image:STS-32 crew.jpg|STS-32 crew]]</nowiki></code> which yields: [[:image:STS-32 crew.jpg|STS-32 crew]]

===Images that link somewhere other than the image description page===
{{see also|Wikipedia:Images linking to articles}}
It is possible to make an image that links to a different page instead of to the image description page by using the "<code>|[[WP:PIC#link|link]]=</code>" option. To disable the link altogether and have a [[Wikipedia:ALT#Purely decorative images|purely decorative image]], in the sense that the image is not shown to visually impaired readers, use "{{para|link}}{{para|alt}}", with no arguments for either parameter.

== Image galleries ==
An image gallery displays several pictures in different layouts, including rows and columns. Be aware that different screen size and browsers may affect accessibility for some readers. 

The can be added using both editors:
* VisualEditor - [[Help:Visual editor#Media galleries|Media galleries]]
* Enhanced editor (see examples below)

See [http://www.mediawiki.org/wiki/Help:Images#Mode_parameter Image gallery mode parameters] and {{W|article=Help:Gallery tag}} for more details.  There is also {{tlx|Multiple image}} than can do similar functions.

=== Default gallery of photos example ===
<pre><gallery>
File:Edit button.png|Edit button
File:We Can Edit.jpg|We Can Edit poster
File:Saint icon.jpg|Saint icon
File:Purge-icon.png|Purge icon
</gallery>
</pre>
<gallery>
File:Edit button.png|Edit button
File:We Can Edit.jpg|We Can Edit poster
File:Saint icon.jpg|Saint icon
File:Purge-icon.png|Purge icon
</gallery>

Options:
* showfilename=yes
* showfilename=no

=== Packed hover ===
For example:
<pre>
<gallery mode="packed-hover">
Image:Edit button.png|Edit button
Image:We Can Edit.jpg|We Can Edit poster
Image:Saint icon.jpg|Saint icon
Image:Purge-icon.png|Purge icon
</gallery>
</pre>

Gives (mode: <tt>packed-hover</tt>):
<gallery mode="packed-hover">
Image:Edit button.png|Edit button
Image:We Can Edit.jpg|We Can Edit poster
Image:Saint icon.jpg|Saint icon
Image:Purge-icon.png|Purge icon
</gallery>

=== Traditional ===
<code>mode="traditional"</code>
<gallery mode="traditional">
Image:Edit button.png|Edit button
Image:We Can Edit.jpg|We Can Edit poster
Image:Saint icon.jpg|Saint icon
Image:Purge-icon.png|Purge icon
</gallery>

=== No lines ===
<code>mode="nolines"</code>
<gallery mode="nolines">
Image:Edit button.png|Edit button
Image:We Can Edit.jpg|We Can Edit poster
Image:Saint icon.jpg|Saint icon
Image:Purge-icon.png|Purge icon
</gallery>

=== Packed ===
<code>mode="packed"</code>
<gallery mode="packed">
Image:Edit button.png|Edit button
Image:We Can Edit.jpg|We Can Edit poster
Image:Saint icon.jpg|Saint icon
Image:Purge-icon.png|Purge icon
</gallery>

=== Packed overlay ===
<code>mode="packed-overlay"</code>
<gallery mode="packed-overlay">
Image:Edit button.png|Edit button
Image:We Can Edit.jpg|We Can Edit poster
Image:Saint icon.jpg|Saint icon
Image:Purge-icon.png|Purge icon
</gallery>

=== Slideshow ===
<gallery mode="slideshow" caption="Random Saintapedia images">
Image:Edit button.png|Edit button
Image:We Can Edit.jpg|We Can Edit poster
Image:Saint icon.jpg|Saint icon
Image:Purge-icon.png|Purge icon 
</gallery>

=== Other options ===
{{tlx|Multiple image}} template creates a box with two to ten images arranged vertically or horizontally with captions for the entire box and/or for each images.

==Scaling images==
<pic file="Space weather phenomena illustration.png" width="30%" align="right" caption="Space weather phenomena illustration" />The {{Mw|article=Extension:AdaptiveThumb|label=AdaptiveThumb extension}} allows you to show thumbnails of images that scale with the browser window.  To use this extension, simply put a <nowiki><pic> tag on your page, such as:</nowiki>
:<nowiki><pic file="Space weather phenomena illustration.png" width=30% align=right caption="Space weather phenomena illustration" /></nowiki>
:<!-- <pic src="/mindmap.jpg" width=30% align=right caption="this is a mindmap" /> is another version -->
Limitations
*There is no way to add a link or an alternative text
== Related ==
* {{W|Wikipedia:Picture tutorial}}
* {{W|Wikipedia:Manual of Style/Images}}
* [[mediawikiwiki:Help:Images]]

[[Category:Help]][[Category:Help under review]]

[[Category:Pages with videos]]