This page is a tutorial for using the wiki image-formatting syntax available starting with MediaWiki 1.2 (upgraded in March 2004). The image markup is backwards-compatible, so old instances of images do not need to be upgraded – they already meet the current standards. However, there are a number of additional features available to make the presentation of images in an article cleaner and more attractive.
Basic syntaxThe basic format for displaying an image inline is
[[Image:Image_name.ext|<style options>|Caption text]]
- thumbnail, thumb
- Generates an automatically resized thumbnail image, normally on the right, with the caption text displayed directly underneath. An "enlarge" icon is added. Example: [[Image:Wiki.png|thumbnail|''Law & Order'']]
- The image will have a frame, regardless of whether it is a thumb, and the caption text will be included as a visible caption.
- Makes the image right-aligned; can be used with and without specifying "thumbnail"
- Same as above, but left-aligned.
- The image will be rendered inline, even if the thumbnail option is set
- Render a thumbnail version of the image that is [size] pixels wide (e.g. "150px"). Height is computed to maintain the aspect ratio (i.e. the shape of the image). Specifying this overrides the preferred thumbnail size set in user preferences, so please use sparingly.
Vertical bars (the pipe "|" character) are used to separate options from each other and from the caption text. Unknown options are ignored and the final parameter is used as the caption text.