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

You can display an image on a Confluence page as a thumbnail, such that when a user clicks on the thumbnail image, a new window will pop up showing the full-sized image.

This page shows you how to display a thumbnail of an image using Confluence Wiki Markup Notation. To do this, you need to add the 'thumbnail' attribute to the notation used for displaying an image to a Confluence page. This resizes the original image proportionately, allowing for a maximum height or width of 200 pixels by default.

Please Note:

  • Using the 'Insert Image' icon
    Instead of Wiki Markup, you can use the 'Insert Image' icon. This behaves in a similar way for both the Wiki Markup and the Rich Text editor, as described in Inserting Images in the Rich Text Editor.

  • 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
    See Image File Formats for details of the formats supported by Confluence.

  • Image attributes
    The HTML attributes as described in Displaying an Image override the 'thumbnail' attribute.

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 the Confluence User's Guide.