An attachment is any file that is included with your page. Examples of attachments are screenshots, photographs, other images, Word documents, presentations, PDF documents, videos and sound files. Attachments are useful when you want to share information that exists in another file format. Read more in Working with Attachments.
When you attach a file to a page, Confluence makes a copy of the file and stores it on the Confluence server. Page attachments in Confluence are managed using the 'Attachments' view of the page.
To attach a file, you need the 'Create Attachments' permission. See Space Permissions.
When a page you are viewing contains attachments, a small paperclip icon appears next to the breadcrumbs. Clicking the paperclip icon will take you to the 'Attachments' view, where you will see the full list of attachments.
On this page:
Related pages:
Attaching files
This page describes the following ways of attaching files to a Confluence page:
- Drag and drop files on to a Confluence page.
- Browse to, and upload files from, your computer or network.
To attach a file to a page using drag-and-drop:
- View the page to which you want to attach files.
- Drag one or more files from your computer onto the page. The 'Attach File(s)' message box appears, indicating the upload status of the files being attached to your page.
You can drag and drop more than one file at a time onto a page. You cannot drag a folder of files onto a page.
Expand this section to see other ways to drag-and-drop a file on to a page...
You can also drag and drop files:
- directly onto the 'Attachments' view for the page.
- directly onto the editor view of the page.
- onto any tab of the 'Insert Link' or 'Insert Image' dialogs, which are available from the Insert menu while editing.
To attach a file to a page from the computer's (or network's) file system:
- Choose Tools > Attachments.
- Choose Browse and navigate to the file.
- Select the file and click Open.
- Add a descriptive comment for the file (optional).
- Choose Attach more files if required.
- Choose Attach.
You can attach than one file at a time. You cannot attach a folder of files.
Expand this section to see other ways to upload a file to a page...
You can also browse for, and upload, a file from:
- the 'Attachments' tab of the 'Insert Link' dialog. (While editing the page, choose Insert > Link.)
- the 'Attached Images' tab of the 'Insert Image' dialog. (While editing the page, choose Insert > Image.)
Attachment versions
If you upload a file with the same name as an existing attachment, Confluence will rename the old file and keep it as a previous version. Read more about Attachment Versions and Viewing Attachment Details.
Notes
- Reusing attachments: If you want to display the same file on more than one page, the best way is to put the attachment on a page (say, page A) and then use the Include Page Macro to include page A into page B, page C, and all the pages where you want the diagram, presentation, or other file. Alternatively, you can display an image that is attached to another page.
- Updating the original file: Any changes you make to the source file do not affect the copy that was uploaded to Confluence. To update the Confluence copy, you need to upload the new version of the file.