Edit Files

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

You can edit any file attached to a Confluence page using your preferred desktop application, then save the file back to Confluence automatically. You can edit Office documents, Photoshop files, Keynote presentations — any attached file with a compatible application installed on your computer.

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

This feature is available in Confluence 6.11 or later. Using an earlier version? You can still edit Microsoft Office documents or upload your files manually. See our guide to managing files

On this page:

Edit an attached file

To edit files, you'll need to install the Atlassian Companion app and allow it to connect to your Confluence site. Once the Companion app is installed and running, you can start editing.

To edit a file in Confluence:

  1. Click the file to open it in preview.
  2. Click Edit with.
  3. Select the application in which you want to edit your file.
  4. Make your changes and then save your file in the desktop application.
  5. In Confluence, click Upload to confirm you want to save the edited file as a new version.

Screenshot: 'Edit with' option in file preview

Screenshot: uploading an edited file in Confluence

Install and connect the Atlassian Companion app

The Atlassian Companion app manages the download and re-upload of files you edit in Confluence. 

The first time you edit a file, you'll be prompted to install the Companion app and allow it to connect to your Confluence site.

  1. Click the file to open it in preview.
  2. Click Edit with.
  3. Follow the prompts to download and install the Atlassian Companion app.
  4. Launch the Companion app.
  5. In the Companion app, click Trust to confirm you want to connect to Confluence.

You can also download and install the app manually for Mac or Windows.

Enterprise installation

We don't currently provide an MSI installer for automating deployment of the Atlassian Companion app to Windows. See Jira for more information:

CONFSERVER-56225 - Getting issue details... STATUS  

Terminal server environments

The Edit Files option isn't compatible with terminal server environments (for example, Windows Remote Desktop Services) where each virtual desktop session shares the same network interface. This may be something we include in a future release. See Jira for more information:  CONFSERVER-56302 - Getting issue details... STATUS

Change your default app

Confluence allows you to edit files in your operating system's default app for that file type (for example, .psd files will open in Photoshop). To change the app your Confluence file opens in, change the default app in your operating system.

Manually upload an edited file

You can only upload changes back to Confluence if those changes are saved in the original file. You won't be able to upload if:

  • you edit the file and save it as a new version
  • the application you’re using saves the file in a different format to the original — for example, from a PowerPoint file (.pptx) to a Keynote file (.key).

If this happens, you can upload your new version manually:

  1. Click the original file in Confluence to open it in preview.
  2. Click the Upload a new version  button and select your new file version.
  3. Click Done.

What to do if you lose your edited file

If you close a file and can't upload it back to Confluence (for example, if you lose internet connection), you can access a backup from the Atlassian Companion folder on your computer.

Follow our guide to accessing Confluence files edited with the Atlassian Companion app.

File size limits

Confluence won't allow you to upload your changes if the edited file is larger than your site's maximum file size limit. This limit is set by your system administrator. By default the limit is 10 MB, but your admin may have increased or reduced it. Check out Upload Files for more information. 

Revoke trust between Confluence and the Companion app

If you want to disconnect the Companion app from your Confluence site, you can remove it as a trusted site.

To revoke trust:

  1. Click the Companion app icon in your system's toolbar.
  2. Choose Clear all trusted domains.

Note: clearing trusted domains won't kill active connections. If you select Clear all trusted domains while editing a file, you'll still be able to upload those changes back to Confluence.

Disable the edit files option

Admins can remove the edit files option. This means the Edit with button won't appear when you open a file in preview.

To disable the edit files option:

  1. Go to

    > Add-ons

  2. From the drop-down menu, select System.
  3. Click Confluence Previews from the displayed list.
  4. Click the enabled modules link.
  5. Hover on the Companion edit button module and click Disable.

Last modified on Sep 10, 2018

Was this helpful?

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