Documentation for Confluence 5.4.
Documentation for Confluence OnDemand and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

When viewing a wiki page that displays an attached Office document, you can launch your Office editor directly from Confluence. This allows you to edit a Word document from within Confluence and save it back to Confluence.

This is just one of the ways Confluence can interact with Office documents. For an overview of all Office Connector features, please refer to Working with the Office Connector.

 (info) Your System Administrator 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 in the Confluence Administration Guide and discuss any configuration problems with your administrator.

Prerequisites for Editing an Attached Office Document

The Office Connector allows you to edit Office files embedded in a wiki page or from the page's attachments view.

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

Browsers
  • 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.
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 wiki page:

Operating System

Office Version

Browser

  • Windows 7,
  • Windows Vista, or
  • Windows XP with Service Pack 2 or 3
  • OpenOffice 2.x – 3.x, or
  • Microsoft Office XP, 2003, 2007 or 2010
  • Internet Explorer 8.x – 9.x, or
  • Firefox – latest stable version
  • Mac OS X 10.5 and 10.6
  • Firefox – latest stable version
  • Linux
  • OpenOffice 2.x – 3.x
    The only known supported Office editor for Linux is OpenOffice. But in theory it should work with any WebDAV-aware application.
  • Firefox – latest stable version

Editing an Office Document in your Office Application

To edit an Office document in your Office application:

  1. There are two ways to do this:

    • From an Office document embedded on a page:
      1. Go to a Confluence page with an Office document embedded on it.
      2. Choose Edit Document above the embedded document.

        Screenshot: Page with an embedded Word document showing the 'Edit Document' link
    • From an Office document in a list of attachments:
      • If an Office file is attached to a Confluence page, you can edit this file directly in your compatible Office application, in one of the following ways:
        • View the list of attachments for a specific Confluence page, then click Edit in Office next to the Office file on the Attachments page. (See Viewing Attachment Details.)
        • View a list of attachments displayed on a page via the Attachments macro, then click Edit in Office next to the Office file in the list of attachments. (See Displaying a List of Attachments.)

  2. A window will pop up, asking you to confirm that you want to open this document.

    Screenshot: Confirmation window in Firefox



    Screenshot: Confirmation window in Internet Explorer

     
     
  3. Click 'OK'. Now you may be asked to log in to your Confluence server.
  4. Enter your Confluence username and password, then choose 'OK'.
  5. The Office document will open in your Office application.
  6. Make the necessary changes, then save the document. It will be saved back into Confluence.

Troubleshooting

Problems? Please refer to our guide to the Office Connector limitations and known issues.

37 Comments

  1. Hi,

    after I upgraded my personal wiki from 2.10.3 to 3.0, the _edit office document_ function doesn't work anymore (the one when you move your mouse and click just above an office (word/excel) document, shown with the {viewfile} macro). The name of the attachment isn't shown when the mouse hovers over, it remains 'hidden'. Foreground and background color are the same. You can select the filename.

    Edit in word (via the tools menu) is working, as well as the WebDav functionality.

    Is there something which needs to be configured (and which I overlooked) ?

    Thanks in advance.

    Regards, Herman.

    1. Hi Herman,

      I noticed that you have raised a bug report for this issue and it has been resolved now. However, for the benefit of others, I will include the link to our Knowledge Base which documents this particular issue. For others who has similar problem, you can refer to this documentation

      Hope this helps.

      Cheers
      JSashi

      1. Can you update with the proper documentation link? :)

  2. Anonymous

    We have the same problem except we are unable to use the Edit in Word functionality as well.  Has anyone found a solution to this?

    1. Hi, there. I hope that you find JSashi's comment above useful. If you have a different issue, feel free to clarify.

  3. Anonymous

    I attached a word document to my page and used

    Error rendering macro 'viewfile' : No attachment name specified
    to view it in the wiki.  However, it lost some of its formatting.  It seems to have stripped out extra spaces between words.  This is problem as I am trying to depict a report format and spaces are important.  It is also not show the text highlighting color in Confluence.

    1. Hi,

      The reason why it seems to have stripped the extra spaces is due to HTML treating multiple spaces as one. You can edit the same document and you will realise the formatting will still be retained in the Word Processor. As a workaround, you could possibly use a hidden table (table without borders) to format your report.

      As for the text highlighting, I guess this is a limitation of the Office Connector plugin. Feel free to raise a feature request at http://jira.atlassian.com. and describe in detail how you require this feature to work. Please add yourself as a watcher, vote for this feature and add your own comments to this feature request. For further details on how we include new features and improvements, you might want to read this page

      Cheers
      JSashi

  4. Anonymous

    I have tested the usability with a few users and realized that users may not figure out how to edit the document without clear explanations.

    • When you click on the document name, it opens the document for editing but you can save it locally only and need to upload it again if you want to post the changes.
    • When you click on "Edit", you can modify the attributes of the document but not the document itself.
    • When you click on "View" you can view the documents but there is no indication that you have to mouse over to the top of the document just to get the link that will open up the document for editing.
      Very confusing....

    I would suggest to:

    • Replace between the functionality behind the "View" and the Document name so click on the document name will open it for WebDav editing. Click on "View" will open it in MS-Office and allow saving locally
    • Change the caption on "Edit" to "Properties".
    1. Hi,

      When you click on the document name, it opens the document for editing but you can save it locally only and need to upload it again if you want to post the changes.

      This is a weird behavior, the Office Connector should allow you to edit a Word document from within Confluence and save it back to Confluence (without having to save it locally and re-upload the document again). Most probably you have run into Read-Only problems in the Office Connector. Please follow the steps in the document provided to troubleshoot the problem.

      If problem still persists, please feel free to raise a support request at http://support.atlassian.com/. Also, please include the information requested here in the support ticket.

      When you click on "Edit", you can modify the attributes of the document but not the document itself.

      Maybe you are confused by the word "Edit", it is actually meant for editing the document attributes. Modifying the document should be done by Office Connector.

      When you click on "View" you can view the documents but there is no indication that you have to mouse over to the top of the document just to get the link that will open up the document for editing.
      Very confusing....

      This is documented under Step 2. Open the document in your office application, under point 1, could you double check on that?

      I would suggest to:

      • Replace between the functionality behind the "View" and the Document name so click on the document name will open it for WebDav editing. Click on "View" will open it in MS-Office and allow saving locally
      • Change the caption on "Edit" to "Properties".

      Thanks a lot for your suggestion. We'd love to listen to all suggestions that would make Confluence better. From my personal opinion, since the document can be opened by WebDav for editing (which is the main purpose of this feature), you can also save a local copy by clicking on the File > Save As when the document is opened by word processor. May I know if this has fulfilled your requirements?

      As for changing the caption on "Edit" to "Properties", you are welcome to raise a improvement request at http://jira.atlassian.com. Please write down your comment, cast your vote, and add yourself as a watcher for future updates. It will then be implemented according to how we implement new features and improvements.

      Cheers,
      Jack

  5. Anonymous

    Is it somehow possible to edit an attached office document directly from the site search page? At the moment I have to click on the "Show" link and then have to click the "Edit Document" button.

    1. Hi,

      I am afraid that this is not currently possible. Feel free to raise a feature request at http://jira.atlassian.com and describe in detail how you require this feature to work. Please add yourself as a watcher, vote for this feature and add your own comments to this feature request. For further details on how we include new features and improvements, you might want to read this page

      Cheers
      JSashi

  6. Anonymous

    Is there a way to access previous versions of the embedded document versions?

    1. Hi,

      Please refer to this documentation for more details on accessing previous version of document/attachment.

      Hope this helps (smile)

      Cheers,
      Husein

  7. Anonymous

    Is there a way to show that a user is editing the current document?  Similar to editing a page where it just notifies you someone has it open.  Thanks!

    1. Hi,

      I am sorry to say that this feature is not currently available in Confluence. However, I have found a feature request here which is related to your question.

      Please feel free to add yourself as a watcher, vote for this feature and add your own comments to this request. For further details on how we include new features and improvements, you might want to read this page.

      Cheers,
      Husein

  8. Anonymous

    Does Office Connect work with Windows 7 (it isn't listed in the OS section)?   I am receiving the "read-only" issue when clicking "edit in office" on a windows 7 computer.  I made the change on the workstation for Excel to open in compatibility mode.  This functionality works fine on other computers.

    1. Hi,

      This is a known issue being tracked here. This workaround works fine with me.

      For more details, please refer to the this page: Troubleshooting Read-Only problems in the Office Connector.

      Hope that helps (smile)

      Cheers,
      Husein

  9. Anonymous

    We are having problems with the "Edit Document" button always showing (previously it only appeared with a mouse over). Also, clicking the button in FireFox no longer works and we have to resort to using IE to edit documents. Any suggestions for resolving these issues would be much appreciated.

  10. I am having issues editing document on a Mac. I downloaded NeoOffice & the patch for Firefox so that the document will open in NeoOffice when the 'Edit Document' button is clicked. A prompt for a username & password comes up & you are able to edit the doc in NeoOffice. However, saving the document will just save it to your computer, not back to the site. Any suggestions?

  11. Anonymous

    Disappointed that Office for Mac and OS X 10.8 (most contemporary Mac OS X) is outside the scope of supported features.... 

    Chrome is a much more mainstream browser....

  12. Using Windows 7 and IE 9 (and FF 15) when I try to open the excel file to edit it an error appears: 

     

    The Internet  address "https://confluence.....xlsx" is not valid."

    Any suggestions about remedies?

  13. Is support for Windows 8 coming soon? I use this feature all the time and now I have to go back to my old machine just to edit a document.

  14. When the "Edit Document" button is disable for a user

    What I have to do for solve this problem?

    This problem has relation with space permissions?

     

  15. Anonymous

    We had lots of problems with this functionality. I can only recommend using GoEdit-Plugin for Confluence, which works like a charm in our company. It´s also not restricted to Office like the Office-Connetor, so we can now use it for any kind of attachment. Especially our marketing department use it a lot for MindManager and their graphics in Illustrator, InDesign, Photoshop and the like. Best of all GoEdit works on Windows, Linux and Mac OS X, so now even my boss can edit attachments with his beloved MacBook Air...(smile)

  16. I would have to agree that this sounds like a great idea, but I cannot get it to work.  Has anyone had success getting the connector to work with Firefox 20.0, Open Office 3.4.1 and Confluence 5.1?  The file that opens is empty and a non-descript error message window pops-up.  I have a screen shot of the error . . . it states "Error reading data from Internet.  Server error message: ."

  17. Anonymous

    Hi, we have problems with embedding documents that contain graphics.

    The graphics all get broken and are shown "in front of" the entire page so that it is even in front of the comment field.

    What do we do wrong? And how can we change the problem? To save the document first as pdf and embed it as a pdf is not what we want because then the graphics are too small and I think there should be another easier way.

    Thanks in advance.

    1. Anonymous

      Can please someone help us?? (sad)

  18. Anonymous

    I can't get the Edit Document link to work in IE 11.  Is anyone else having this issue?  I'll try Firefox.

    1. Internet Explorer 11 is not yet supported in Confluence.  You should have more luck with Firefox. 

    2. Anonymous

      IE11 is changing the cross-browser check-method, and not supporting the old mechanism that Confluence uses anymore. Thats why you get the message "Firefox or Internet Explorer is rquired to use this feature." when hitting the edit Document link in IE11.

      http://msdn.microsoft.com/en-us/library/ie/dn423948(v=vs.85).aspx

      As Rachel Robins says, Confluence is not yet supporting IE11. I'll hope they soon do. Are there any ETA of such an update, Rachel/Atlassian?

       

       

       


  19. When will there be support for Chrome?

  20. I am unable to download an old version of Open Office as suggested in the Mac requirements. This does not work with 4.0.

  21. When will there be support for Chrome?

    1. You can follow this issue here  CONF-23322 - Editing attachments in Office fails with Google Chrome Open .   

  22. Looks like the Chrome Editing bug has been around for some time. Are there plans to address this issue? I will be a major issue in our decision to purchase confluence.