Office Connector Prerequisites

The page describes the software and setup you need to use the Office Connector.

System Administrators can enable or disable the Office Connector or parts of it. The Office Connector options can appear in different places on your Confluence page, depending on the themes and configuration of your Confluence site.Please refer to Configuring the Office Connector and discuss any configuration problems with your administrator. 

Overall prerequisites

  • 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 enabling plugins 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.

Prerequisites for viewing Office and PDF files in Confluence

If you want to use the View File macro, or to view Office files attached to a Confluence page, you need the setup described below.
Browsers and Flash Player

You can use any browser to view an Office file on a page or attachment view, provided that you have installed Adobe Flash Player version 9 or later. You do not need to have an Office application installed on your computer in order to view Office files in Confluence.

File Types

Confluence can display files compatible with Microsoft Office 97-2013, and PDF files, of the following types:

  • .doc and .docx
  • .xls and .xlsx
  • .ppt and .pptx
  • .pdf

Prerequisites for importing Word documents into Confluence

  • Document import can import Microsoft Word documents of the file types .doc and .docx. These must be valid Word 97-2013 format documents.

Prerequisites for editing Office files directly from Confluence

The Office Connector allows you to edit Office files embedded in a Confluence page or in the attachments list for a page.

To make use of these editing capabilities, you will need the setup described below.


  • If you are using Firefox, you will need to install a Firefox add-on. Firefox will prompt you to do this, the first time the add-on is required. You will find instructions in Installing the Firefox Add-On for the Office Connector.
  • Note: No Chrome support. Chrome does not support WEBDAV clients, so this feature will not work. Please refer to this issue for more information: CONF-23322.

Operating Systems

Editing Microsoft Office files in Mac OSX is not supported. Please refer to this issue for more information CONF-17250.

Office editors

To edit Office files, you will need to have Microsoft Office or OpenOffice installed (see the configuration matrix below).

  • If you are using Firefox, you can choose which of the above editors you want to use. The Firefox add-on allows you to configure this option for each file type. See Installing the Firefox Add-On for the Office Connector.
  • If you are using Internet Explorer, you will need Microsoft Office. You cannot edit Office files in OpenOffice when using Internet Explorer.

Configuration matrix

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

Software Operating System Browser
Microsoft Office 2013
  • Windows 7
  • Windows 8
  • Internet Explorer 11
  • Firefox – latest stable version
Microsoft Office XP, 2003, 2007, 2010
  • Windows 7
  • Windows Vista
  • Windows XP (Service Pack 2 or 3)

OpenOffice 2.x – 3.x

  • Windows 7
  • Windows Vista
  • Windows XP (Service Pack 2 or 3)
  • OS X
  • Linux
  • Firefox – latest stable version
  • Internet Explorer supported versions
    (Windows Platforms only)

Note: The only known supported Office editor for Linux is OpenOffice. 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) please raise an issue and tell us as much as you can about your operating system, application version, document version (if its different to the version of Office / Open Office you're using to open the document) and browser. 

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport