Manage Files

Still need help?

The Atlassian Community is here for you.

Ask the community

Files are attached to Confluence pages. See Upload Files to find out about attaching files to pages.

Once attached you can download, delete, and edit these files. Confluence will also manage attachment versions when you upload a new file or change the location of the attachment.


On this page:


Related pages:

Download attachments

Any user with permission to view a page can also download the files attached that page. 

To download an individual attachment:

  • Select the Download button in the file preview, or
  • Go to
    More options
    > Attachments
    and select the checkbox next to the attachment, and select Download, or
  • Go to
    More options
    > Attachments
    and then right click on the file name and save the link.

To download multiple files as a zip file, select the checkboxes next to the attachments you want to download (maximum of 20 per page), then select Download.

To download all attachments as a zip file: 

  1. Go to
    More options
    > Attachments
    .
  2. Select Download all.

There's no option to download all attachments in a space.

Delete attachments

When you remove an attachment from a page or blog post, it doesn't delete it from the site.

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

To delete all versions of an attached file:

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

To delete multiple attachments, select the checkboxes next to the attachments you want to delete, or select the header checkbox to select all attachments on the page (maximum of 20 per page), then select Delete.

Deleted files can be restored from the trash. You'll need to be a space admin to do this. 

Space Admins can also delete specific versions of an attachment:

  1. Go to
    More options
    > Attachments
  2. Select the expand arrow next to the attachment name to see the list of attachment versions
  3. Choose Delete next to the version you want to delete.

Deleted file versions are not recoverable from the trash.

Screenshot: Attachments and attachment versions

Screenshot: Multi-select attachments to delete or download

Upload a new version of an attachment

There are two ways up upload a new version of an attached file.  You can:

  • Upload a file with the same file name to the page. 
  • Use the Upload a new version  button in the file preview to upload a file with a different name (for images and PDFs only). 

To view attachment versions:

  • Go to
    More options
    > Attachments
  • Click the expand arrow next to the attachment name.

All earlier versions of the file will appear.  

You can't revert to an earlier version of the file, but you can choose to remove earlier versions if you have Space Administrator permissions. 

Move an attachment to another page

You'll need the 'Add Page', 'Add Attachment' and 'Remove Attachment' space permissions to move an attached file to another page. 

To change the page that a file is attached to:

  • Go to
    More options
    > Attachments
  • Choose Properties next to the attachment you want to move.
  • Enter the name of the page you want to move the attachment to (for example My Destination Page).
  • Choose Save.

If you want to move the file to a page in another space, add the space key before the page name (for example DOC:My Destination Page).  

Edit properties of an attachment

You'll need the 'Add Attachment' permission in the space to edit the file properties. 

To edit the properties of an attached file:

  • Go to
    More options
    > Attachments
  • Click Properties beside the attachment you want to edit. 

You can:

  • change the file name
  • add a comment (used in the version list and also by the Snapshot image effect)
  • change the MIME type
  • move the attachment to another page
  • add a label. 

Changing the MIME type may cause your file to display incorrectly. 

View all attachments in a space

There are two ways you can view all files in a space.  You can:

  • Use the Space Attachments macro to display the list of files on a page.
  • Go to the space and select Space tools > Content Tools from the bottom of the sidebar Then choose Attachments.

You can use the filters to only show files with a particular label or file extension.  

Screenshot: Space attachments macro


Last modified on Feb 29, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.