Edit in Office using the Office Connector

Still need help?

The Atlassian Community is here for you.

Ask the community

This page covers how to edit files using the legacy Edit in Office method.

Confluence provides two methods for editing files:

  • Edit files using the Atlassian Companion app 
    Allows you to edit any type of file, if you have a compatible application installed. Requires you to install Companion on your computer. 
  • Edit in Office using the Office Connector 
    Allows you to edit Microsoft Excel, PowerPoint, and Word files with a compatible browser and Microsoft Office application. Provided for organizations who can't use Companion.

Your Confluence administrator will decide which method is best for your organisation.

To check which method is available in your site, go to the file preview (click an image or file thumbnail). If you see the Edit button, your site is using the Companion app method, so the information on this page doesn't apply to you.

Editing Office files attached to a page

The Office Connector allows you to edit Office files that are attached to pages, if your site does not use the Companion App method. You'll need to use a browser, operating system and application (either Microsoft Office or OpenOffice) as described in the compatibility matrix below.

To edit an Office document attached to a Confluence page:

  1. Go to
    More options
    > Attachments
  2. Choose Edit in Office beside the attachment you want edit.
    Your browser will ask you to confirm that you want to open the file. 
  3. Choose OK
    You may also see a security warning or be asked to log in to your Confluence server - enter your Confluence username and password, then choose OK.

  4. The file will open in your Office application - make your changes then save the document. It will be saved back to Confluence. 

(warning) Edit in Office will not work on files that have special characters (such as ' # @ or €) in the filename. 

Screenshot: Edit in Office option on the attachments page


Other ways to edit

Edit options also appear in the:

Office Connector pre-requisites

You can only edit files using the Office Connector if your system administrator has enabled this feature on your site. By default, Confluence requires you to install the Atlassian Companion app to edit attached files. See Edit Files

Configuration matrix

Edit in Office is only compatible with desktop applications. Online versions of Office applications are not supported.

You need one of the following software combinations to edit Office files from your Confluence page.

SoftwareOperating systemBrowser

Microsoft Office 2010 SP2, 2013, 2016, 2019

  • Windows
  • Chrome
  • Firefox1
  • Internet Explorer 11
  • Edge

Microsoft Office 2011, 2016, 2019

  • Mac OS
  • Chrome
  • Firefox
  • Safari

Microsoft Office XP, 2003, 2007, 2010 SP1

  • Windows
  • Internet Explorer 11

OpenOffice 2.x – 3.x

  • Windows
  • Linux
  • Chrome
  • Firefox
  • Safari

LibreOffice 6.x

  • MacOS
  • Windows
  • Linux
  • Chrome
  • Firefox
  • Safari

1 Firefox only works in Windows with Confluence 7.1 and later.


Note

The known supported Office editors for Linux are OpenOffice & LibreOffice, but in theory it should work with any WebDAV-aware application.

If you experience problems editing documents using the Office Connector (using an application, operating system and browser combination above) contact our support team, who can raise an issue about it. Tell us as much as you can about your operating system, application version, document version (if it's different to the version of Office / Open Office you're using to open the document) and browser.

Here are a few common issues:

  • Using Internet Explorer? You can only edit documents in Microsoft Office. OpenOffice is not supported.
  • Using Linux? You can only edit documents in OpenOffice. Microsoft Office is not supported.
  • Special characters in the filename? Edit in Office does not work for files with special characters (like ' # @ €) in the filename. See  CONFSERVER-22403 - Getting issue details... STATUS
  • Not seeing the Office Connector options? Your system administrator needs to enable this feature, and can control how it appears on your site. See Enable Edit in Office as a dark feature and Configuring the Office Connector.

Enable Edit in Office

You need System Administrator global permission to do this. 

To enable the legacy Edit in Office functionality:
  1. Go to Administration  > General Configuration > Office Connector.

  2. Choose Enable Edit in Office for all users and save your changes. 

This will disable Companion app functionality for all users in the site. 

Troubleshooting

Having problems with the Office Connector?

  • The WebDAV plugin must be enabled, because the Office Connector uses WebDAV to transfer information to and from Office documents. The WebDAV plugin is bundled with Confluence, and can be enabled or disabled by the System Administrator. If necessary, refer to the instructions on managing system and marketplace apps and configuring the WebDAV options.
  • Ensure that your Confluence server's base URL is set correctly (see Configuring the Server Base URL to find out how to check this). When a user edits a Confluence page in Word and then uploads the page back to the Confluence server, the base URL determines where the document will be saved. If the base URL is incorrect, the documents may be saved to a different Confluence server.
  • Using Office 2013? Your administrator will need to enable 'Allow authentication tokens in the URL path' in the Office Connector configuration. See Configuring the Office Connector.

See the Office Connector Limitations and Known Issues knowledge base article for more troubleshooting tips.

Last modified on Feb 5, 2020

Was this helpful?

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