Upload Files

When you upload a file, such as an image or document, it will be attached to the current page. 

You can then choose to display the file on the page as a link, an image or embed it in the page (using a macro). 

To upload a file you'll need the 'Add Attachments' space permission.

Upload a file

There are many ways to attach a file to a page.  

In the editor you can:

  • Drag the file directly onto the page. 
  • Go to Insert > Files and images and upload a file.

When viewing a page you can:

  • Drag the file directly onto the page.
  • Go to > 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 cannot attach a folder of files (including folders created by applications like Keynote - you'll need to export your presentation to zip or other format). 

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 Display Files and Images to find out more. 

The maximum file size you can upload to Confluence is set by your system administrator. By default it is 10mb, but your administrator may have increased or reduced this limit.

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. Version history is kept for all attachments. See Manage Files to find out more. 

Any changes you make to the source file will not affect the copy that was uploaded to Confluence. To update the Confluence copy, you need to upload the new version of the file.

Notes

Was this helpful?

Thanks for your feedback!

35 Archived comments

  1. User avatar

    Dirk Loeckx

    I posted something a few weeks ago on attaching an attachment to multiple pages. My primary goal is not to be able to show the attachment on multiple pages, but to have the attachment as, well, attachment, on both pages. I.e., I have two pages on our new IT system, and want to attach the latest Powerpoint to both pages.

    Even more, within this Powerpoint, I would like to be able to include relevant slides in both pages (i.e. slide 1 in page 1 and slide 2 in page 2). There seems to be a workaround to make this work, but unfortunately sometimes the slide is gone and it seems not to be exportable to pdf.

    27 Jul 2012
  2. User avatar

    Anonymous

    Is is possible to change the comment after an attachment has been added?

    05 Nov 2012
    1. User avatar

      Ryan Anderson [Atlassian]

      Yes. Go to the Attachments View of your Confluence page and click 'Properties' for the attachment you'd like to change the comment for.

      08 Nov 2012
  3. User avatar

    Romil Mamaniya

    I can insert an image on the page using a URL. But I want to "attach" an image file using a URL so that I can later use it in the Gallery macro. Is it possible?

    11 Jan 2013
  4. User avatar

    Anonymous

    Hi all,

    Im using confluence 3.2 and I want to attach 20 images at the same time to make a gallery macro. However, it just allows me to upload 1, can I upload several images there? I already tried the the drag and drag function but is not working. Then I read the support and it says that i might need to install Gears–> I go to install it and google says that that feature was replaced by HTML 5... I´m very confused. Do you guys have an idea about how could i do that?

    Thanks!!!

    Juan

    17 Jan 2013
  5. User avatar

    Anonymous

    Google Gears is not supported anymore.

    17 Jan 2013
  6. User avatar

    Jörg v. Kirschbaum

    We want to automatically attach new versions of an already attached file to a page. Files are located on an internal webserver with consistent naming. Is there a way to achieve this?

    28 Jan 2013
  7. User avatar

    Anonymous

    I have a situation where i created a document and attached some images, these where showing until a couple of days ago, now in place of the images there is a grey box with the following text showing: "Unkown attachment", when i click on the box it says:

    "The requested content cannot be loaded. Please try again later."

    We tried some hours later and a couple of days later but the images still do not show.

    These images are also no longer in the attachments section.

    Does anyone have any idea what can be done for this?

    Thanks

    Kind regards

    Confluence Fan

    31 Jan 2013
    1. User avatar

      Anonymous

      I was receiving the same error on an .exe I was trying to attach, I thought it was the file type as I was able to attach another file. After I created the page and went to remove the attachment I had added in testing I used the Attachments page with the drag and drop box to try and upload my .exe. Here I received:

      The following error(s) occurred:

      • Total upload size is too large (35.00 MB). Reduce total filesize to below 35.00 MB
      30 Apr 2013
  8. User avatar

    aaron wideen

    Are there any filetypes that cannot be uploaded to a confluence instance?

    Thanks,

    Aaron

    29 Apr 2013
    1. User avatar

      Dawn Ross

      Looks like it's not uploading my zip files. 

      12 May 2014
      1. User avatar

        Rachel Robins [Atlassian Tech Writer]

        Hi Aaron and Dawn, I'm not aware of file type restrictions applying to attachments (I have just successfully uploaded .exe and .zip attachments in both installed Confluence and OnDemand) however there is a limit to the file size allowed.  This can be set by your Administrator - there is more info here Configuring Attachment Size

        13 May 2014
  9. User avatar

    Anonymous

     

    Hi,

    I wonder if it is possible to sort attachments in different folders or something like that? And also if it is possible to search for content inside attachments?

    Best regards

    13 Jun 2013
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Attachments are added to pages, so that is one way you can group them - by creating several pages with attachments on them. You can also add labels to attachments, which can be helpful when searching. 

      Confluence does search content inside common attachments, such as PDFs. There is more info here Searching the content of attachments

      Hope this helps. 

      13 May 2014
  10. User avatar

    Steven TABRI

    Hi,

     Is it possible to limit the number of attachment for a page? (I don't mean "max number per upload")

    Regards

    Steven

    13 Aug 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Steven, I'm not aware of a way to limit the maximum files that can be attached to a page I'm afraid.  There's some info here (Configuring Attachment Size) on limiting the size of attachments, and changing the way they are indexed, but not sure that will help your particular problem.

      14 Aug 2014
  11. User avatar

    Di Robinson

    I see Anonymous mentioned attaching multiple attachments with click and drag (back in January 2013) and that this had something to do with Google Gears.  Does anyone know if it is possible in 5.2.2?  I often have a swag of attachments to attach and find doing them one at a time quite tedious!

    26 Aug 2014
    1. User avatar

      Stephanie Arnaud [Atlassian]

      Hi Dianne, drag-and-drop of multiple attachments is supported in most modern browsers now (you can see more information about supported platforms here). Additionally, multiple upload will be available very soon for images via the Upload button of the Insert image dialog. Hope this helps!

      26 Aug 2014
      1. User avatar

        Di Robinson

        thank you!  Had to get someone from help desk to clarify - but all good now.  thanks for such a quick response!

        26 Aug 2014
  12. User avatar

    Sang Phan Van

    How can I attach files quickly on the page that I am editing? For example, the date, I only press // after choosing date. User mention, I only press @ after choosing user. Please help me the way to attach files quickly. Thank you.

    29 Oct 2014
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Van,

      The quickest way I've found is to type ! into the editor and choose Open image browser, then drag and drop the files into the dialog.

      29 Oct 2014
      1. User avatar

        Sang Phan Van

        Hi Giles Brunning,

        I tried your suggestion, but it only can attach image, not files such as PDF. I tried many ways but it only has the way that I should click "+ Insert more content" on the tool and choose "Attachment".

        If you have any tips this one, please tell me. Thank you so much.

        30 Oct 2014
        1. User avatar

          Giles Brunning [Atlassian Technical Writer]

          It might depend on your version of Confluence. I've just tested this approach in 5.6.3, and it seems to work with at least .docx, .pptx, and .pdf, as well as images obviously.

          When you drag files into the image browser it'll tell you that it can't display a thumbnail, but it should attach the file.

          30 Oct 2014
          1. User avatar

            Sang Phan Van

            My version of Confluence is 5.5.3. Maybe, it is not be supported.

            18 Nov 2014
            1. User avatar

              Giles Brunning [Atlassian Technical Writer]

              I tried it with my local instance of 5.5.3 and it seems to work for me, so unfortunately I'm not sure what the issue is.

              There's definitely better functionality in this area in the newer versions of Confluence, and hopefully even better to come next year.

              20 Nov 2014
              1. User avatar

                Viktor Mitew

                Hello,

                 

                Thank you all for the replies. My current version is 5.1.5. Maybe when we upgrade it will work.

                 

                Best regards.

                20 Nov 2014
              1. User avatar

                Sang Phan Van

                I hope so. Thank you so much.

                20 Nov 2014
  13. User avatar

    Viktor Mitew

    Hello,

    Is there a possibility to share one attached file between multiple pages? 

    Thank you for your support. Best regards.

    11 Nov 2014
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Victor,

      You can embed an image, or link to a file, on as many pages as you need to, as long as it's attached to a page in Confluence.

      Choose Insert > ImageInsertAttachment, depending on what type of file you want to link to, or type ! in the editor and start typing the name of the file.

      11 Nov 2014
  14. User avatar

    Viktor Mitew

    Hello,

    I am sorry, I did not make myself clear. What I want to do is the following:

    I have a parent page with an excel attached. The excel has x sheets. I have created x child pages and I want to visualize / edit every sheet of the excel in a different child-page using the Office excel Macro.  In the configuration of the macro I need to select the attachment, but I have no access to it since it is attached to the parent page. 

    Attaching the file on each separate child page will probably result in me having x files with only one sheet that is up-to-date.

    That is why I am asking if there is a possibility to share the file between the child pages so it can be edited by all of them and all the information will remain in that very file.

     

    Thank you in advance. Best regards.

    12 Nov 2014
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Victor,

      There's no way to do that that I'm aware of. You could try asking over at answers.

      16 Nov 2014
  15. User avatar

    Deepti

    Hello,

    I have an attachment on page A and I am referencing it in page B and page C. When I update the attachment on page A, page B and page C still refer to the old version instead of picking up the new version of the attachment. Why does this happen?

    Thanks,

    Deepti

     

    07 May 2015
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Deepti,

      I tried to recreate your attachment issue, but it seems to be working for me.

      I attached an image to Page A, then included it (embedded and as a link) on Page B. When I update the image on Page A, it updates on Page B.

      If you're still having trouble, I'd suggest contacting support.

      07 May 2015
    1. User avatar

      Hans-Peter Geier

      I guess the page author has pasted the http.... address of the attachment into the reference to the attachment, instead of using the Confluence-internal way. When copying an URL from Confluence, it is of the format http:.....?version=N&modifiedDate=xx/xx/xxxx  . Such links will not be updated when a new version of the attachment is uploaded, but is kinda hard-coded to version N forever.  Solution: authors either use the Confluence way for linking to attachments, or at least (when using http for what-ever reason) remove everything after the ? from the URL.

      07 May 2015
    1. User avatar

      Deepti

      Thanks Giles and Hans. I guess it was something temporary. It is working fine now.

      17 May 2015
Powered by Confluence and Scroll Viewport