Skip to end of metadata
Go to start of metadata

Remember that attachments remain on a page until they are removed from the Attachments page. This means that all screenshots remain ‘attached’ even when deleted from a page, taking up server space. Old images need to be identified and removed.

Step-by-step guides

View attachments in a Space

To view the attachments associated with a space: 

  1. Go to a page in the space, and at the bottom-left of the page, click Space Tools > Content Tools.

  2. Click the Attachments tab to see a list of all the attachments in the space along with their details and the pages they are attached to.

  3. Sort the files for faster searching:by files of a particular type by:

    1. To sort by file type, type the last part of the file name in the Filter By File extension box (e.g. enter pdf to see only .PDF format files) and click Filter or hit ENTER.

    2. To see only files that have a particular label or labels, type the label in the Filter by Label box. If you enter more than one label, separate them with commas or spaces. Confluence will show only attachments that have all the labels specified using AND logic, not OR. Click Filter or hit ENTER.

View attachments on a page

When a page you are viewing contains attachments, there are two ways to view the files.

  1. Click the small paperclip icon that appears above the page name.

  2. Choose Tools > Attachments.

You will see a list of the attachments in the page along with their details. The list of attachments includes options for viewing the files, and other actions, provided the user has the relevant permissions. Users can also remove attachments or edit attachment properties and labels.

Delete an attached file

You'll need the 'Delete Attachment' space permission to delete an attached file.

To delete all versions of an attached file:

  1. Go to the page that contains the attachment.
  2. Go to   > Attachments
  3. Choose Delete next to the attachment you want to delete.
  4. Choose Delete to confirm your action.

Space Admins can also delete a specific version of an attachment:


A page can display an image that is attached to another page. If you remove an image that is used on a page, readers will see an error message on that page.

Example error message that appears when image attachment is removed: 

Attachment details

The following are the fields regarding attachments:

  • Name is the name of the attached file.
  • Size tells you how much space the attachment takes up. You can sort by size by clicking the column title.
  • Creator is the person who attached the file. Clicking on the link takes you to the persons' user profile.
  • Creation Date is the date the file was attached. You can sort by date by clicking the column title.
  • Labels are keywords, or tags, that you can enter to categorize the attachments. 
  • Last Mod. Date (in the space view) is the date the file was last modified.
  • Attached To (in the space view) tells you which page contains the attachment.
  • Comment (in the page view) is a short description of the attachment.
  • Properties link (in the page view) lets you edit the attachment details. 
  • Remove link (in the page view) lets you delete the attachment, or a specific version of the attachment.
  • Edit in Office link (in the page view) appears next to Office files only, and lets you edit that attachment.
  • Attach File option lets you add another attachment or another version of an existing attachment.

To see all versions of an attachment, choose the arrow on the left of the attachment name.

Use the Space Attachments Macro

This page explains how to use the Confluence Space Attachments MacroThe Space Attachments macro displays a list of all files attached to pages in a space. It shows details of the file and the includes a link to the page a file is attached to. It does not indicate if an attachment is currently 'active' or displayed on the page. 


For questions or comments, contact the Computer Services Help Desk