Help:Contents

Image Help

To embed an internal file in a text, you just have to specify its file name with the internal link syntax ([[ ]]). Thus, [[image:tst.png]] gives .

Here, "internal" refers to both the same project and Commons. An image name is assumed to refer to the one in the same project if it exists there, otherwise to one on Commons. If neither exists a link to the upload page appears, with class="new" ("red link"). The link is rendered the same as one to the edit page of the non-existing image page, except that the former shows the canonical form of the pagename.

Only images proper can be automatically presented, sound is not automatically played.

An embedded internal image automatically links to the image page, which shows the full image, or, depending on preferences, a reduced version with a link to the full version. The page also provides info about the image.

Images on MediaWiki:Bad image list cannot be embedded; they appear as a regular link to the image page. Exceptions to allow a listed image on particular relevant articles can be added. See, for example, w:en:MediaWiki:Bad image list.

Options

The internal-link style markup for embedding a file can take various options separated with a pipe character ("|"). In brief, they are [[Image:{name}|{type}|{location}|{size}|{upright}|{border}|{caption}]].

Type

'thumb' or 'frame'. Causes image to be displayed with specific formatting (see below).

Location

'left', 'right', 'center' or 'none'. Determines placement of the image on the page.<ref>class="floatleft", class="floatright", class="center" with class="floatnone", and just class="floatnone". The actual position depends on css.</ref> Defaults to 'right' if the type is 'thumb' or 'frame'. The combination thumb and none can be useful in a table, to allow a caption but reduce the space around the image. Text that follows the image with location left or right floats, in the case of center or none it does not (if necessary, reduce the browser window width to see this in the examples). An image without the specification thumb or frame, and without location specified (not even none) is displayed inline.

Size

{width}px or {width}x{height}px, reduces or enlarges an image without specified type, reduces an image if thumb is specified. Even if width and height are specified the image will keep its original aspect ratio: either the width or the height will be equal to the specified maximum, whichever allows the other to be <= the maximum.

Upright

for use only on images that are taller than they are wide. Adjusts a thumbnail's size to factor times the default thumbnail size, rounding the result to the nearest multiple of 10 pixels. For instance, "upright=1.5" makes the image larger, which is useful for maps or schematics that need to be larger to be readable. As a guide "upright=1" is the same width as a standard thumbnail, and "upright=0.75" is the same as using "upright" alone.

Border

adds a border around the image.

Link

To allow an image to link to an arbitrary title, URL or just nowhere.

Caption

Any element which cannot be identified as one of the above is assumed to be caption text. If there is more than one the last one is effective, even if it's an empty string. Specifying a caption parameter is strongly recommended for the sake of accessibility. Images without type do not have a caption, the caption parameter becomes a "title"-attribute, which is shown in the hoverbox. A real caption can contain links.

In the case of a non-existing image, a link to the upload page is provided. If type has been specified this is still applied, with the caption. Location is also applied. Remaining elements, even image size, are treated like caption: the last one of any of these is effective as label of the upload link.

Single pipes inside a pair of double rectangular brackets, such as in link and image syntax, are shielded by these brackets from being interpreted as table syntax. However, this does not apply to consecutive pipes, which might occur in the expanded wikitext for image syntax if an optional parameter is not applicable. Thus in the case of an optional parameter, make the pipe optional as well. A pipe in e.g. the then- or else part of a conditional parser function can be coded as {{!}}, due to Template:!. Alternatively, add an unconditional space in the image syntax: a pipe-space-pipe combination is not a double pipe, so not taken as table syntax, while a parameter position containing just a space is ignored in the interpretation of the image syntax.