Upload Files
Upload a file
You can then display the file on the page as a link or an image, or you can use a macro to embed it in the page.
To upload a file, you'll need the Add Attachments space permission. Without this permission, the relevant option in the editing toolbar will not appear.
Pages in your site may use the new editor or the legacy editor. This page explains how to use both editors.
Use these links to jump to the section detailing the editor you use:
Which editor does your page use
When you edit a page, you can look over the toolbar for visual indicators, like the differences between the text color pickers, the inclusion of undo / redo buttons, or an emoji icon in the new editor toolbar. You'll also notice that the Publish… or Update and Close buttons were moved to the top right in the new editor.
New editor
Legacy editor
New editor
This section provides the details for uploading files using the new editor.
Upload a file
There are two ways to attach a file to a page you are editing:
Drag the file directly onto the page.
Click the Files & images icon in the toolbar, and upload a file.
There are two ways to attach a file to a page you are viewing:
Drag the file directly onto the page.
Go to ••• > Attachments, and upload a file.
Regardless of the state of the page, you can upload multiple files at a time.
Accepted file types and size
Confluence allows you to attach most file types, but you can't attach folders (including folders created by applications like Keynote). If you'd like to upload a folder, export it to a zip file or other compressed format, then upload to Confluence.
Although just about any file type can be attached to a page, not all file types can be displayed on or embedded in a page. For more information, see Display files and images. Unless otherwise specified by your admin, files must be under 100MB.
File versions
If you upload a file with the same name as an existing attachment on the same page, Confluence overwrites the existing attachment. Confluence maintains version history for all attachments. For more information, see Manage files.
Changes you make to the source file won't affect attachments in Confluence. To update a file you've attached to a Confluence page, upload a new version of the file.
Avoid using special characters in page or attachment names, as the page or attachment may not be found by Confluence search and may cause some Confluence functions to behave unexpectedly.
Legacy editor
This section provides the details for uploading files using the legacy editor.
Upload a file
There are a couple ways to attach a file to a page.
To upload when editing:
Drag the file directly onto the page.
Go to Insert > Files and images and upload a file.
To upload when viewing:
Drag the file directly onto the page.
Select to open the more options menu, then select Attachments and upload a file.
You can attach multiple files at a time.
Accepted file types and size
Confluence allows you to attach most file types, but you can't attach folders (including folders created by applications like Keynote). If you'd like to upload a folder, export it to a zip file or other compressed format, then upload to Confluence.
Although just about any file type can be attached to a page, not all file types can be displayed on or embedded in a page. See the list of displayable files below. Files must be under 100 MB.
Displayable image files:
File type | Extension | Media Type |
Microsoft Windows Bitmap | .bmp | image |
Dicom | .dcm | image |
Graphics Interchange Format | .gif | image |
High Efficiency Image File Format | .heif, .heic | image |
JPEG | .jpg, .jpeg | image |
Portable Network Graphics | .png | image |
Photoshop | .psd | image |
Tagged Image File Format | .tif, .tiff | image |
All other displayable files (will display as a thumbnail):
File type | Extension | Media Type |
Zip | .zip | archive |
AAC | .aac | audio |
AC3 | .ac3 | audio |
AIFF | .aif, .aiff | audio |
Monkey Audio | .ape | audio |
AU | .au | audio |
FLAC | .flac | audio |
M4A | .m4a | audio |
MIDI Files | .mid, midi | audio |
Matroska (Audio) | .mka | audio |
MOD Files | .mod | audio |
MPEG Audio Layer II/III | .mp3" | audio |
OGG (Audio) | .ogg, .spx | audio |
RealAudio | .rm | audio |
WAV | .wav | audio |
WMA | .wma | audio |
Adobe Illustrator | .ai | doc |
CSV | .csv | doc |
Diff | .diff | doc |
Microsoft Word | .docx, .doc, .dot, .docm, .dotx, .dotm | doc |
OpenDocument Drawing | .odg, .otg | doc |
OpenDocument Presentation | .odp, .otp | doc |
OpenDocument Spreadsheet | .ods, .ots | doc |
OpenDocument Text | .odt, .ott, .odm | doc |
Microsoft Office | doc | |
OpenOffice 1.0 Document | .sxw, .stw, .sxc, .stc, .sxi, .sti, .sxd, .std | doc |
Adobe PDF | doc | |
Perl | Perl | doc |
Microsoft PowerPoint | .ppt, .pptx, .pot, .pps, .pptm, .potx, .potm, .ppsx, .ppsm | doc |
PostScript | .eps, .ps | doc |
Python | doc | |
Ruby | .rb | doc |
RTF | .rtf | doc |
Text | .txt | doc |
WordPerfect | .wpd | doc |
Microsoft Excel | .xls", .xlt, .xla, .xlsx, .xlsb, .xlsm, .xltx, .xlam, .xltm | doc |
3GPP | .3gpp | video |
ASF | .asf | video |
AVI | .avi | video |
DV | .dv | video |
FLV | .flv | video |
M2TS | .m2ts | video |
M4V | .m4v | video |
Matroska (Video) | .mkv | video |
QuickTime/QT | .mov, .qt | video |
MP4 | .mp4 | video |
MPEG | .mpg, .mpeg, .ts | video |
OGG (Video) | .ogg | video |
WebM | video | |
WMV | .wmv | video |
File versions
If you upload a file with the same name as an existing attachment on the same page, Confluence will overwrite the existing attachment. Confluence maintains version history for all attachments. For more information, see Manage files.
Changes you make to the source file won't affect attachments in Confluence. To update a file you've attached to a Confluence page, upload a new version of the file.