Displaying Images

You can display an image on a Confluence page when:

  • The image is attached to the page.
  • The image is attached to another page in the same Confluence site, even if in another space.
  • The image is on a remote web page.

Once the image is displayed on the page, you can:

  • Move the image to a new position on the page by dragging or cut and paste.
  • Change how the image appears on the page.
  • Add a title and alt text for the image.
  • Link from an image to another page.

Displaying an image attached to the page

There are several methods for attaching image files to a page.
Once you have attached an image to a page, there are different methods for choosing where on the page the image should appear:

Using the 'Insert Image' dialog

Once an image is attached to the page, you can edit the page to choose where the image should appear.

To position an attached image on the page:

  1. While editing the page, position the cursor where you want to place the image.
  2. Choose Insert > Image and choose the Attached Images tab.
  3. Select the required image and choose Insert (or just double-click the image).

Using autocomplete

Once an image is attached to the page, you can use autocomplete while editing the page to choose where the image should appear.

To position an attached image on the page:

  1. While editing the page, position the cursor where you want to place the image.
  2. Trigger the autocomplete function by typing '!'.
  3. Choose the image from the list that appears.

Using drag-and-drop

Depending on the browser you are using, you can attach and position an image in one step. While you are editing a page, simply drag-and-drop an image file on to the page. The image is attached to the page and is placed at the current cursor position.

Displaying an image attached to a different page

You can display an image that is attached to a different page of the same Confluence site, as long as you know the name of the image. This approach can make it easier to manage and reuse your images by allowing you to keep them all in the same place.

To display an image attached to a different page:

  1. While editing the page, position the cursor where you want to place the image.
  2. Choose Insert > Image and choose the Search tab.
  3. Enter the name of the image.
  4. Choose whether to search the current space or All Spaces and choose Search.
  5. Select the required image from the search results and choose Insert.

Alternatively, you can cut and paste the image from another page (the image will still only be attached to the original page).

Displaying an image from a remote web page

You can display an image from a remote web page on your Confluence page, without needing to attach it to your page. You need to know the URL for the image, not for the web page it appears on. Note that you should have permission to use that image on your page.

To display an image located on a web page:

  1. While editing the page, position the cursor where you want to place the image.
  2. Choose Insert > Image and choose From the Web.
  3. Type in the URL for the image. An example is: http://atlassian.wpengine.netdna-cdn.com/wp-content/uploads/AtlassianBushRegeneration-12January2012-083-trunc.jpg
  4. Choose Preview to check that the URL and image are correct.
  5. Choose Insert.

Alternatively, you can simply cut and paste the image from a web page.

Controlling the image appearance

When editing the page, select the image to show the image properties panel. The panel allows you to set the display size, add a border and effects and link the image to other pages. 

To set the size of the image, do one of the following:

  • Choose one of the size 'preset' buttons (the image width in pixels is displayed to the left).
  • Choose the image size text and enter a new image width in pixels (you can specify a size between 16px and 900px).

Images are displayed as thumbnails.

To add a border to the image:

  • Choose Border in the image properties panel.

To add a hyperlink to the image:

  • Choose Link in the image properties panel. 

To align an image:

  • Select the image and choose the paragraph alignment buttons on the editor toolbar.
  • If you choose the left or right alignment, the text will wrap around the image. The text does not wrap for centre alignment.

To add effects to an image:

  • Choose PropertiesEffects in the image properties panel.
  • Select an effect and choose Save.

Note: The Instant Camera effect only works with Latin character languages, due to a lack of handwriting style fonts in multi-byte languages.

To add a caption to an image:

  • Choose Effects in the image properties panel and choose the Instant Camera image effect.
  • Save the page.
  • Choose ToolsAttachments to go to the 'Attachments' view of the page.
  • Choose Properties next to the image file.
  • Add a comment to the attachment. The text in your comment will appear as the image caption.

You will need to re-enter the comment each time you upload a new version of the image.

Screenshot: The image properties panel beneath an image


Screenshot: Examples of image border effects

Setting other image attributes

You can add a title and alt text to your image in the image properties panel. The image title displays when the user hovers over the image or views the full size image. The alt text is used by screen readers and when the image cannot be shown.  

To add a title and alt text:

  • Choose Properties > Title in the image properties panel.
  • Enter a title and alt text and choose Save.

Other attributes can also be set by using the Insert > Wiki Markup function from the editor toolbar, then using the syntax described in Confluence Wiki Markup.

Displaying a gallery of images

See the Gallery Macro.

Image file formats

You can attach image files of any format to a page. Confluence supports the following image formats in the Gallery macro and when displaying an image on a page:
  • gif
  • jpeg
  • png
  • bmp (depending on browser support)

Notes

Displaying image effects can be resource intensive. Confluence limits the threads that are dedicated to displaying image effects so that it does not impact your whole instance. If a thread is not available, Confluence will display the image without the effect.  

The following knowledge base article provides information if you need to adjust the number of threads - Image effects are not displayed in Confluence 5.5 or later

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport