This documentation relates to an earlier version of Confluence.
View this page in the current documentation or visit the current documentation home.

Skip to end of metadata
Go to start of metadata

(info) You need to edit in 'Wiki Markup' mode to include macros in your page.

Use the Thumbnail macro when you want to display a thumbnail of an image attached to any Confluence page. When a user clicks the thumbnail image, a new window will pop up showing the full-size image.

The macro resizes the original image proportionately, allowing for a maximum height or width of 200 pixels by default.

Setting the size of the thumbnails for your Confluence instance


A Confluence Administrator can change the size of thumbnails via the Administration Console. This will also affect the images displayed by the Gallery macro.

Image formats


Confluence will only create thumbnails for these file formats: gif, jpg, and png. The bmp format is not supported.

Image attributes


The HTML attributes as described in Displaying an Image override the thumbnail macro settings.

Thumbnail of image attached to this page

What you need to type

What you will get


'waterfall.jpg' is the name of your image.

Thumbnail of image attached to another Confluence page

What you need to type

What you will get

!Space attachments directory^fish.gif|thumbnail!

'Space attachments directory' is the name of the other page.

Specifying the default alternative text for a thumbnail image

You can specify a comment for an attached image, which will be used as the default alternative text when the image is displayed as a thumbnail.

Attaching a new image file - Enter the relevant comment in the Comment box provided when you attach the file to the page.
Applying a comment to existing image attachment - The 'Attachments' tab of the page displays all attached files. Click 'Edit' in the row of the attached image entry. In the 'New Comment' text entry field, enter the default alternative text that should be displayed whenever a thumbnail of that image appears.

What you need to type

What you will get

!Space attachments directory^thumb-text.jpg|thumbnail!


Displaying an Image
Gallery Macro
Image File Formats
Attaching Files to a Page
Working with Macros

Take me back to Confluence User Guide