• Products
  • Documentation
  • Resources

Upload a file

When you upload a file, such as an image or document, Confluence attaches it to the current page. 

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

New Confluence Cloud editor toolbar

Legacy editor

Legacy Confluence Cloud editor toolbar

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

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

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.

 

Additional Help