Display Files and Images

Files can be displayed on a page as a thumbnail, a link or embedded using a macro.  There are a few different ways to Upload Files.

How files are displayed depends on the type of file you uploaded. 

Display images

Add interest to your pages by adding images. You can display all common image types including .jpeg, .png, .gif and .bmp (depending on browser support).

Insert an image

There's a few ways you can insert an image into your page:

  • Go to Insert > Files and Images on the editor toolbar and then either upload some files or select existing files, or
  • Drag the image file directly into the editor, or
  • Type ! and choose an attached image from the autocomplete drop down.

On this page:

Related pages:

Inserting an image attached to a different page

You can display an image that is attached to a different page of the same Confluence site, if you know the name of the image. 

To display an image attached to a different page:

  1. Go to Insert > Files and Images and choose the Search on other pages.
  2. Enter the name of the image.
  3. Choose whether to search the current space or All Spaces and choose Search.
  4. 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 be attached to the original page).

Insert an image from the web

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. 

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 > Files and Images and choose Images from the web.
  3. Enter a URL for the image. (example: 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 copy and paste the image from a web page.

Change 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. 

From the image properties panel you can:

  • Choose a preset size for the image
  • Enter a width for the image (between 16px and 900px)
  • Add a border around the image
  • Link the image to a page or URL
  • Align the image (you can use the left and right align buttons to make the text wrap around the image too)
  • Add a title, which is shown when you hover over the image (go to Properties > Title)
  • Add alt text, which is used by screen readers and when the image can't be shown (go to Properties > Title)
  • Add effects to the image such as drop shadow or snapshot (go to Properties > Effects).


To add a caption to an image using the Instant Camera effect:

  • Choose Effects in the image properties panel and choose the Instant Camera image effect.
  • Save the page.
  • Go to > Attachments 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.

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

Delete images

If you delete an image on a page, the attached file will not be deleted from the page. Go to > Attachments to delete the attachment completely from the page. 

Seeing an 'unknown attachment' placeholder on your page? This means that the attached file has been deleted from the page (or another page).

Preview images and PDFs

Click an image or PDF link when viewing a page to launch the preview. 

The preview includes images from the web that are displayed on the page, or images and PDFs that are attached to the page (even if they are not currently displayed on the page).

In the preview you can:

  • Download the image file.
  • Upload a new version of the file.
  • Comment on the file.
  • Zoom in, out or fit the image to the width of your browser.
  • Browse like a slideshow using the next and back buttons.
  • See other files attached to the page and select a thumbnail to preview that file.
  • Switch to a full screen presentation mode.

Note: Internet Explorer 9 can't preview PDF files. You can download the file to view the original version. 

Display multimedia files

You can display multimedia files (such as video, audio and animation) that are attached to your page using the Multimedia Macro

Display online multimedia (such as YouTube or Vimeo videos) using the Widget Connector Macro

Display Office files and PDFs

Inserting a file in a page is a great way to make useful documents, spreadsheets, presentations and other files available to your team. 

There are a several ways you can display an office or PDF file on a page:

  • as a link - people can click the link and download the file.
  • as a thumbnail - people can click the thumbnail to preview (Office and PDFs) or download the file (other file types).
  • embedded in the page - people can view the content of the file without leaving the page. 

In the editor go to Insert > Files and select a file to insert. The file will appear on your page as a thumbnail. 

Click the thumbnail to resize it or to switch to showing the file as a link. 

Embed a file in the page

You can embed PDFs, presentations, spreadsheets and other Office documents into your page using a View File macro. 

Drag a PDF or Office file into the editor to automatically upload it and embed it into the page. 

See View File Macro to find out more. 

Display other file types

Other file types can be uploaded and displayed on the page as a link or with a placeholder thumbnail. 

Display a list of files on a page

There are several ways you can display a list of files on a page.  You can:

You can also use the File List blueprint for uploading, viewing and managing lists of files. 


Image effects

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