View source for Help:Visual file markup

This page explains how to display images and videos in Wikipedia pages.

{{Wiki markup}}
<div style="border:1px solid #A3B1BF; background:#f5faff; padding:1em; margin:0em 1em 1em 0em; float:left; font-size:105%">
The best markup for adding an image to a page in most situations is

<code><nowiki>[[File:Example.jpg|thumb|alt=Alternative text|Caption text]]</nowiki></code>


The best markup for adding a video to a page in most situations is 

<code><nowiki>[[File:Example.ogg|frame|alt=Alternative text|Caption text]]</nowiki></code>
</div>
<br clear="left" />

File markup begins with the filename, preceded by the <code>File:</code> prefix with both enclosed in double square brackets – for example <code><nowiki>[[File:Example.png]]</nowiki></code>. Codes may then be added. Each code must be separated with a pipe (<code>|</code>). Some codes specify a display mode, which is like a [[preset]] – it will determine the way the image is displayed and which additional properties can be specified to further customise how the image is displayed. Codes may be in any order – with the exception of the caption, which should be last. Only the filename is required. This must be placed first.

Many existing files use the <code>Image:</code> prefix instead of <code>File:</code>. The rest of the markup is exactly the same. Additionally, <code>Image:</code> may be used with any type of file, not just images.

{{TOC limit}}

==File types==
Before a file can be used, it must be uploaded to either Wikipedia or the [[Wikimedia Commons]] sister project. Uploading to Commons is recommended as files can be used by other sister projects. Files being used under fair use provisions must be stored on Wikipedia. The markup is the same regardless of where it is uploaded.

The following visual file types may be uploaded:
:'''Image formats'''
* [[JPEG|jpg]]/[[JPEG|jpeg]] – recommended for photographic images.
* [[Scalable Vector Graphics|svg]] – a [[Vector graphics|vector]] format recommended for drawings and line-art illustration.
* [[Portable Network Graphics|png]] – recommended for non-vector iconic images.
* [[Graphics Interchange Format|gif]]
:'''Video formats'''
* [[ogg]]/[[Theora|ogv]]
:'''Mixed content formats'''
* [[Portable Document Format|pdf]]
* [[DjVu|djvu]]

==Display modes==
There are four display modes:
* Basic
* Thumbnail
* Framed
* Frameless

===Basic mode===
[[/basic mode|See examples]]

A file in basic mode does not specify a display mode. Files are displayed at full size by default. Images are displayed inline unless a horizontal alignment is specified.

===Thumbnail mode===
[[/thumbnail|See examples]]

A file in thumbnail mode uses the codes <code>thumb</code> or <code>thumbnail</code>. This will display a thumbnail with a caption. Default size is 220 pixels wide unless the full size file is smaller. Registered users can specify their own default size if they wish.

In normal circumstances, images are scaled down automatically by Wikipedia's server. This does not happen for animated GIFs. Instead the original animated GIF is downloaded, and whether the image is scaled to fit the allotted space depends on the capabilities of the browser. Videos are not scaled down either, which wastes bandwidth. Use framed mode or upload a lower resolution file.

===Framed mode===
[[/framed|See examples]]

A file in framed mode uses the codes <code>frame</code> or <code>framed</code>. This will display the file at full size with a caption. Because files are not scaled down, framed mode is not appropriate for large images, but is a good choice for video – provided the video is not too large.

===Frameless mode===
[[/frameless mode|See examples]]

An file in frameless mode uses the code <code>frameless</code>. This will display a thumbnail without a caption. Default size is 220 pixels wide unless the full size file is smaller. Unlike thumbnail mode, images are displayed inline unless a horizontal alignment is specified.

==Adjusting properties==
===Caption===
Text entered at the end of the markup is used as a caption. It does not require a code. Links and normal text formatting options can be used in captions too.

<code><nowiki>[[File:Example.png|thumb|alt=Example alt text|</nowiki>'''<span style="color:red;">''Example caption''</span>'''<nowiki>]]</nowiki></code>

{| class="wikitable"
!
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Video
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Mixed content
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|}

===Horizontal alignment===
[[/horizontal alignment|See examples]].

Position the file to the right.

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">right</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>
----
Position the file to the left.

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">left</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>
----
Position the file in the centre. Text will not flow around the file.

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">center</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>
----
Position the file to the left. Text will not flow around the file.

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">none</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

===Size===

Files will keep their original aspect ratio.

In normal circumstances, images are scaled down automatically by Wikipedia's server. This does not happen for animated GIFs. Instead the original animated GIF is downloaded, and whether the image is scaled to fit the allotted space depends on the capabilities of the browser. Videos are not scaled down either, which wastes bandwidth. Consider uploading a lower resolution file.

====Resize tall files====
[[/upright|See examples]]

Reduce the width for tall, thin files. This is generally better than specifying a width as it respects user preferences.

<code><nowiki>[[File:Example.png|thumb|</nowiki>'''<span style="color:red;">upright</span>'''<nowiki>|alt=Example alt text|Example caption]]</nowiki></code>
----
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. As a guide "<code>upright=1</code>" is the same width as a standard thumbnail, and "<code>upright=0.75</code>" is the same as using "<code>upright</code>" alone.

<code><nowiki>[[File:Example.png|thumb|</nowiki>'''<span style="color:red;">upright=''Factor''</span>'''<nowiki>|alt=Example alt text|Example caption]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Mixed content
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

====Specify a size====
[[/size|See examples]]

Scale the file to make it the specified number of pixels in width (e.g. <code>100px</code>).

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">''Width''px</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>
----
Scale the file to make it the specified number of pixels in height (e.g. <code>x150px</code>).

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">x''Height''px</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>
----
Scale the file to be no wider and no higher than the specified number of pixels (e.g. <code>100x150px</code>).

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">''Width''x''Height''px</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

===Add alt text===

Specify the [[alt attribute|alt text]] for the image. This is intended for visually impaired readers. See [[WP:ALT]] for how this typically should differ from the caption.

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">alt=''Example alt text''</span>'''<nowiki>]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

===Links===

Ordinarily, a file will include a hyperlink to its [[Help:File page|description page]], a page with information about the file itself. The options below allow the link to point to a different page or to be disabled. For images, the link is the image itself. Videos include an information icon below the video.

Unless the file is public domain attribution must be provided in some other fashion. See [[Wikipedia:Images linking to articles]] for more information.

====Modify file link====
[[File:Example.png|150px|right|link=Wikipedia|alt=Example alt text]]
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. [[#Image maps|Image maps]] offer more possibilities.

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">link=''Name of page''</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

====Disable file link====
[[File:Example.png|150px|right|link=|alt=Example alt text]]
No hyperlink is created. Clicking on an image or mixed content file will have no action. The link to "About this file" is removed when playing a video .

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">link=</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

===Add a border===
[[Image:Flag of Japan.svg|border|right|150px|White flag containing solid red circle]] [[Image:Flag of Japan.svg|right|150px|White flag containing solid red circle]]

Add a one-pixel border around the file. This can be useful when it is important to distinguish a file from the background. Consider using <code>thumb</code> or <code>frame</code> instead.

<code><nowiki>[[File:Example.png|</nowiki>'''<span style="color:red;">border</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

===Inline display===
An image with no horizontal alignment specified will be displayed inline with the text.

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Video
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

====Vertical alignment====
Images must be placed inline. [[:File:Flag of Hungary vertical.svg]] is used as an example.

[[Image:Flag of Hungary vertical.svg|baseline|7px|link=|alt=]]Align the bottom of the image with the [[Baseline (typography)|baseline]] of the text.

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">baseline</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>
----
[[Image:Flag of Hungary vertical.svg|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.

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">middle</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>
----
[[Image:Flag of Hungary vertical.svg|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>".

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">sub</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>
----
[[Image:Flag of Hungary vertical.svg|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>".

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">super</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>
----
[[Image:Flag of Hungary vertical.svg|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 [[Ascender (typography)|ascenders]] in letters like lower-case "h".

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">text-top</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>
----
[[Image:Flag of Hungary vertical.svg|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 [[descender]]s in letters like lower-case "y".

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">text-bottom</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>
----
[[Image:Flag of Hungary vertical.svg|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.

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">top</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>
----
[[Image:Flag of Hungary vertical.svg|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.

<code><nowiki>[[Image:Flag of Hungary vertical.svg|</nowiki>'''<span style="color:red;">bottom</span>'''<nowiki>|7px|link=|alt=]]</nowiki></code>

===Change the image displayed===
====Initial still image====
[[File:Big Buck Bunny small.ogv|thumbtime=27|frame|Thumbtime of 27 seconds specified to show the title.]]

Use the frame from the video at the given time as the initial still image. Without a thumbtime parameter, a frame from the midpoint of the video is used. '''Time''' takes the form of hours, minutes and seconds separated by colons. For example:
* <code>thumbtime=21</code> – Time syntax using seconds only
* <code>thumbtime=0:23</code> – Time syntax using minutes and seconds
* <code>thumbtime=0:0:33</code> – Time syntax using hours, minutes and seconds

<code><nowiki>[[File:Example.ogg|</nowiki>'''<span style="color:red;">thumbtime=''Time''</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Video
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|-
!
Mixed content
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|}

====Select a page====
[[File:Abroad - 1882.djvu|thumb|right|150px|page=13|This is page 13]]
Images can be excerpted from [[DjVu]] or [[Portable Document Format|Pdf]] files, with an optional ''page'' parameter.

<code><nowiki>[[File:Abroad - 1882.djvu|</nowiki>'''<span style="color:red;">page=''number''</span>'''<nowiki>|alt=Example alt text]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Video
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Mixed content
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|}

====Provide a different thumbnail====
[[File:Anime stub 2.svg|thumb=Anime stub.png|alt=Example alt text|Example caption]]
You can link to one image from a thumbnail's small double-rectangle icon [[File:Magnify-clip.png|link=|alt=]], but display another image using "{{para|thumb|<var>Displayed image name</var>}}". 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 example, the double-rectangle links to ''[[:File:Anime stub 2.svg]]'' but the image displayed is ''[[:File:Anime stub.png]]''.

<code><nowiki>[[File:Anime stub 2.svg|</nowiki>'''<span style="color:red;">thumb=''Anime stub.png''</span>'''<nowiki>|alt=Example alt text|Example caption]]</nowiki></code>

{| class="wikitable"
! 
! Basic
! Thumbnail
! Framed
! Frameless
|-
!
Images
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Video
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|-
!
Mixed content
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:U2713.svg|20px|alt=Works|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|
[[File:Black x.svg|20px|alt=Doesn't work|center]]
|}

==Specialised uses==
Instead of using the file markup above, markup for specialised uses has been created which may be used instead.
=== 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 {{tl|Wide image}} template. For example:

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

=== Co-aligning ===

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

{{multiple image
 | width     = 100
 | 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
}}
<pre style="overflow:auto;">
  {{multiple image
   | width     = 100
   | 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
  }}
</pre>
{{-}}

The same template can also align pictures vertically:

{{multiple image
 | direction = vertical
 | width     = 100
 | 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
}}
<pre style="overflow:auto;">
  {{multiple image
   | direction = vertical
   | width     = 100
   | 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
  }}
</pre>
{{-}}

=== Image maps ===

<imagemap>
Image: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>
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 <code><nowiki>http://projects.vassar.edu/1896/democrats.html</nowiki></code>. This image is generated by the following markup:

<pre style="overflow:auto;">
<imagemap>
Image: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>
</pre>

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 [[mw:Extension:ImageMap|image map documentation]], regions can be specified as circles, rectangles, and arbitrary polygons, and the blue "i" icon [[Image:Desc-20.png|x14px|link=|alt=]] can be moved or suppressed. Also, the image can be specified as a "<code>thumb</code>" or "<code>frame</code>", which means it has alt text and a caption in the usual way, with a double-rectangle icon [[Image:Magnify-clip.png|link=|alt=]] instead of the blue "i" icon [[Image:Desc-20.png|x14px|link=|alt=]].

==Galleries==
Galleries of multiple files may be produced. These are typically placed towards the end of the article.

There is no one standard way of producing a gallery. The options available are:
* [[Wikipedia:Gallery tag|The gallery tag]] – This does not support alt text or the thumbtime parameter for videos.
* [[Template:Gallery]] – This does not support the thumbtime parameter for videos.
* [[Template:Image gallery]] – This does not support the thumbtime parameter for videos.
* Combine the file markup above with [[Help:Table#Wikitable as image gallery|table markup]]

== Link to a file without displaying it ==

To link to a description page without displaying the file, put a colon before the prefix.
: <code><nowiki>[[:File:Example.png]]</nowiki></code>
: [[:File:Example.png]]

You can also link directly to the file using "<code>Media:</code>" instead of "<code>File:</code>".
: <code><nowiki>[[Media:Example.png]]</nowiki></code>
: [[Media:Example.png]]

In both cases [[Help:Piped link|piped links]] also work.

==See also==
*[[Wikipedia:Extended image syntax]]

[[Category:Wikipedia how-to]]
[[Category:Wikipedia editor help]]
[[Category:Wikipedia image help]]