Documentation for Confluence 5.8 (Server).
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

If you are using Firefox as your browser, you will need to install an add-on into Firefox (the Firefox WebDAV Launcher) in order to use some features of the Office Connector. You will be prompted to install the add-on the first time you try to use a function which requires it.

(warning) For more information on the browsers, operation systems and application combinations required to use the Office Connector see Office Connector Prerequisites.

On this page:

Related pages:

Installing the Firefox Add-On

The first time you try to edit an attached Office document in Firefox you'll be prompted to install a WebDAV add-on for your browser. Without this add-on you can't edit Office documents from Firefox. 

  1. Choose Edit in Office or Edit Document next to the document you wish to edit.
    You'll see a prompt to download the add-on.  
  2. Choose OK.
    Your browser will ask you to confirm that you want to allow the add-on. 
  3. Choose Allow.
    An installation dialog like the one below will appear.
  4. Choose Install Now.
    Once the installation is complete you'll be prompted to restart Firefox. Make sure you've saved any open pages or other work in your browser before you restart. 
  5. Next you need to configure the add-on, and tell it which applications to use. 

Configuring the Add-On

After installing the add-on you need to configure it, to tell the add-on which desktop applications to launch for each file type.  

Configuring the add-on is slightly different in each operating system.  

Configuring the add-on in Windows

In most cases the add-on will automatically configure itself, based on information from the system registry. The first time The first time you edit a new file type, the add-on will look up the default editor for that file type and make that the permanent setting.

If you want to override the registry settings, or the automatic configuration is not working, you can configure the Firefox add-on manually.

  1. In Firefox locate the WebDAV Launcher add-on and choose Options.
    The WebDAV Launcher Options dialog, like the one below, will appear. 
     

  2. Enter a file extension in the File Extension field.
    For example, to associate the 'doc' file extension with Microsoft Word 2003 you would type doc in the File Extension field.

    Using Office 2007 or later?

    You should configure the WebDAV launcher to open both Office 2003 file extensions (doc, ppt and xls) and Office 2007 and later file extensions (docx, xlsx and pptx).

  3. Enter the Application Path - you can either: 
    • Choose Auto to load the associated application from the Windows registry, or
    • Choose Browse to find the application on your computer, or
    • Manually enter the path to the application's executable file.

  4. Choose Add to add the file extension association to the list.
    Repeat this process for all the file extensions you need. 

Configuring the Add-On in Mac OS X

The configuration procedure is similar to Windows, as shown above. Note that there is no 'Auto' button in Mac OS X.

You can't currently edit documents in Mac OS X. See  CONF-25594 Open .

Configuring the Add-On in Linux

The only known supported Office editor for Linux is OpenOffice (see Office Connector Prerequisites).

There is no automatic configuration on Linux. You will need to associate each file type with your Office editor in Firefox. Note that there is no 'Auto' button in Linux.

The configuration procedure is similar to Windows. For both Ubuntu and OpenSUSE, the configuration will look something like this:

File Extension

Application Path

doc and docx

/usr/bin/oowriter

ppt and pptx

/usr/bin/ooimpress

xls and xlsx

/usr/bin/oocalc

Security Risks

Please be aware that there are security risks in installing this add-on to Firefox. Internet Explorer is exposed to the same risks, because it can directly open Office documents.

Summary of the risks:

  • Office documents can contain macro viruses. Before opening an Office document, make sure that you trust the source of the document.
  • There are known flaws in the Office file formats and Microsoft Office that an attacker can exploit to gain control of your machine. Microsoft has fixed the known exploits in the latest Service Packs for all Microsoft Office versions, but new exploits may arise at any time. Be sure that you trust the source of a document before opening it.

The add-on reduces the risk by supporting:

  • Same origin policy - the add-on can only open documents from the same host that initiated the action.
  • Digital signature - the add-on is digitally signed. When you install the add-on please verify that it is signed by Atlassian.
  • Prompt the user for confirmation - You will always be warned before a file is opened. Please read these warnings carefully before opening a file. The warning tells you the complete URL of the file as well as the complete application path of the application opening the file.

Information about this Firefox add-on

Add-on name:

WebDAV Launcher

Description:

Adds the ability to launch a WebDAV URL directly in a WebDAV-aware client.

Latest version:

See the WebDAV Launcher add-on page at Mozilla

Compatible with:

All versions of Firefox, up to and including the latest stable version.

Author:

Atlassian Pty Ltd

60 Comments

  1. Anonymous

    Hi,

    When will the FF4 be supported?

    Thanks,

    Alex.

    1. The official FF4 release date is tentatively scheduled in November 2010 according to:

      After checking at http://jira.atlassian.com for a feature request, I am not able to find it yet. Could you please create an improvement request at http://jira.atlassian.com to see when will Firefox 4 be supported in Confluence?

      Thanks and regards,
      Joachim

  2. Anonymous

    Is there any workaround to handle Microsoft Office on a MAC?

    Where are the restrictions/missing functionalities?

    Cheers, Holger

  3. Does anyone know how to configure Firefox or any other setting that save back to confluence does work with NeoOffice on Mac?

  4. Anonymous

    In my Confluence 3.4.2 "edit in word" func doesn't work for office 2007-2010. It opens empty document in Word. It works only in offive 2003.

      1. Anonymous

        I have the same problem, your links are not useful: it's' manual page. It's not a read only prolems, webdav plugin it's not able to run

        the path for example: http://10.0.133.14:8090/plugins/servel/confluence/editinword/7995448/attachments/wim-installato-forecast-2011-v.2.xls

        If O use office 2003 all works fine

        Please I have 500 licensed users and I cannot works fine.

        Carlo Balducci

        1. Hi Carlo,

          We are sorry to hear you experiencing such issue on your instance.

          We highly recommend you to create a ticket on our https://support.atlassian.com/ channel so that our support engineer would be able to investigate your issue and hopefully provide you a workaround or solution if available.

          Cheers,
          Septa Cahyadiputra

  5. Anonymous

    what about Firefox 4 support?

    1. Anonymous

      I second that motion. Even though Firefox 4 is still in beta, it would be really handy to have the WebDAV connector right now.

      Thanks!

      1. Anonymous

        FF is now in RC2. Plz work on this plugin as we all use FF for our WIKI.

  6. Anonymous

    Strongly agreed!

  7. Firefox 4 has been released -- I'm typing this comment from it.

    The WebDAV Launcher 1.04 plugin is disabled, there are warnings about it being disabled in the upgrade process. There is an outstanding issue: Host WebDAV launcher add-on for Firefox at Mozilla and provide information for people wanting to install it

    Searching for "atlassian" or "webdav" in the add-ons doesn't turn anything up regarding WebDAV Launcher.

  8. Same here, what do we do with official gold release of FF4? It's so much faster, really need this webdav for all our wikis.

    Also, Please Update the Webdav Add-On's About this add-on link to this page and not atlassian.com.

    It's totally confusing and misleading to go to atlassian.com to get information about the addon, as there is nothing there at all about it.

    1. I created a support ticket regarding the issue: https://support.atlassian.com/browse/CSP-58997.  But have since closed it as a duplicate, to point to Sarah's ticket.

    2. Hallo Mark,

      About Firefox 4, please see my comment below. (smile)

      About updating the "About this add-on link": I've added a request for this update. Please feel free to add a comment too, and to watch the issue for further updates: CONF-22059.

      Cheers, Sarah

  9. Hallo to everyone asking for Firefox 4 support. (smile)

    At the moment, Atlassian does not offer support for Firefox 4 in any of the Confluence functions, and therefore also not for the Office Connector add-on. Please refer to the documentation on supported platforms.

    I've added a feature request to our issue tracker, requesting support for Firefox 4: CONF-22057. If you like, you can "watch" that issue so that you receive updates about progress. You could also comment on the issue, and vote for the issue too, to let the development team know how you feel. The dev team doesn't usually monitor the documentation, so they're unlikely to see all the comments on this page.

    I hope this helps to explain the currently-supported browsers, and gives you somewhere to add your feedback.
    Cheers, Sarah

    1. Anonymous

      Following the tracked issue, there is now an updated version of the WebDAV plugin for FF4 at https://addons.mozilla.org/en-US/firefox/addon/webdav-launcher/

      1. Anonymous

        Bummer, it's not for Mac yet...  Anyone know when it will be?

  10. Anonymous

    I have followed these instructions and still cannot edit my documents from firefox.

  11. Anonymous

    Can't get this working on FF 4 even with the latest version of WebDAV Launcher.

  12. Anonymous

    I'm using Confluence 3.4.5, but it's too dificult to "select the relevant version" of this document.

    With "WebDAV Launcher 1.0.5" I have no problems anymore with Firefox 4.0.1.
    But now it doesn't work with FF 5.0.

    1. Anonymous

      After upgrading to Firefox 5, I had a similar experience.  I solved it by re-installing the add-on:

      1. Go to the WebDAV Launcher v1.0.5 Add-on page in Firefox v5
      2. Clicked the Add to Firefox button
      3. Clicked the Install Now button (wait three seconds for it to enable)
      4. Restarted Firefox when prompted for changes to take effect

      There's a note about an expired certificate that was fixed – wonder if we just had an old version of the Add-on?

  13. Can't get it to work in FF 5.0 on Mac :(

  14. Anonymous

    Not working with Firefox 5.0.1 - tried the above resolution

    Any other ideas?

  15. Anonymous

    What about Firefox 5 ? I have installed and configured WebDAV, but when i click EDIT DOCUMENT. Nothing happends

  16. Anonymous

    I dare to ask about FF 6.0 compatibility:)

    /Kate

  17. Its written that it will work Firefox 4.0 - 7.* but if you want to install, Firefox tells that it is not compatible to 6.0.2 :-(

  18. I have the same problem as Sven. I am on FF 6.0.2 and want to edit documents. I don't have easy access to IE (on a mac and don't want to have to bring up virtual machine). Any workarounds for this problem? 

  19. @Mark O'Callaghan: You can the the updated Version from here https://addons.mozilla.org/en-US/firefox/addon/webdav-launcher/

  20. Anonymous

    Be careful. Not avalaible with the latest version 7 of FF.

  21. Anonymous

    Any update on compatibility with Firefox 7.0.1?

  22. Is there any place I can look for previous versions of the webdav plugin? I need 1.0.4 and Mozilla only lists as early as 1.0.5.

     

    1. Me too. We are still using Firefox 3.6.

  23. I'm using WebDAV Launcher 1.0.6 with Firefox 10.0.

    Does anybody know how to enable Edit in Office for .odt (OpenOffice Document) or other OpenOffice Document formats?

  24. Is there any way to automate the plugin installation and configuration?

  25. What registry keys are used - can they be set with a script?

  26. What are the application paths for OpenOffie on the Mac?

    I can't just select OpenOffice.app, it will open this folder and I don't know what binary to select now for the connector to work.

    The documentation is very limited on this issue, especially since everyone at Atlassian is using a mac...

    Please help!

     

    1. Anonymous

      I'm having the same issues.  It does not seem that this is really supported for Macs despite the mention above.  The way that macs store the applications means they cannot be selected in the plugin.  It just shows them as folders and for some reason won't let me select the executable file that launches the application in those folders.

       

    2. Hi! I read your message, because i've had the same problem. My workaround was: 1) Naming the Extension without the leading point at the beginning. 2) Open Terminal and drag the OpenOffice.app to the Terminal window. C'nP the displayed path. (Cause of the language maning conventions you can make sure the right destination).

      Can you confirm the workaround?

      Andreas 

       

      1. Hi! yes, this seems to work.

        Thanks for this solution.

        Cheers!

  27. FYI, I use it on Fedora and Ubuntu.

    Firefox 10+ and LibreOffice.

     

  28. Anonymous

    Is not woring with Firefox 13.0.1 pleas help.

     

    1. Anonymous

      Sorry I mean not working with Firefox 13.0.

       

  29. Anonymous

    Witch version is it now?

  30. Above is a long list of  "it does not work for me".  There is no answer how to resolve it.

     

    I add one more: It does not work for me either!

    I'm on Firefox 16, WebDav Launcher 1.0.6, Confluence 3.5.16

     

    It looks like this feature is broken since Firefox 7, with no resolution since ???

     

    The Firefox Error console says:

    NS_ERROR_FILE_NOT_FOUND: Component returned failure code: 0x80520012 (NS_ERROR_FILE_NOT_FOUND)[nsIProcess.init]            Line:89

    jar:file:///C:/Document%20and%20Settings/<user>/Application%20Data/Mozilla/Firefix/Profiles/<..>.default/extensions/webdavlauncher@benryan.com.xpi!/components/URLLauncher.js

     

    The specified file webdavlauncher@benryan.com.xpi exists.

     

  31. Anonymous

    Hi, I've a problem with Ubuntu 12.04, LO 3.6 and Plugin WebDAV 1.0.6

    When I'm editing the file xls, I insert my user id and pwd but I've an "Internal Error 500".

    Thank you

     

     

  32. Anonymous

    I'm trying to deploy this to 100+ PC's in my organization, I can easily deploy the add-on itself so it's available to users in Firefox, but I need to know how it can be deployed with it already configured with the Ext name and application paths.

    Where exactly are the File Extension and Application Path values stored?

    Any help would be appreciated.

  33. I'd like this information as well - we need to be able to deploy this to all staff to help get user buy-in

     

    Anthony

  34. Anonymous

    Hi Anthony, I managed to answer my own question after a few more days of searching.

    The File Extension and Application Path values are stored inside of the 'prefs.js' file inside of the Firefox profile. C:\Users\username\AppData\Roaming\Mozilla\Firefox\Profiles\xxxxxxx.default\prefs.js

    Paste into the file the following string(s) with the variables you require- An example below is for the .xlsx extension pointing to the filepath Excel is installed to

    user_pref("benryan.urlLoaderextInfo.xlsx", "C:\\Program Files (x86)\\Microsoft Office\\Office14\\EXCEL.EXE");

    There are a number of ways to get this onto users machines, I already use the CCK wizard to create extensions with these kind of values defined. http://mike.kaply.com/2012/04/13/customizing-firefox-extensions-and-the-cck-wizard/

     

    Steve

    1. Anonymous

      Further to what I wrote above. This method will require an extra line listing the extensions you're including. For example if I have entries for .xls, .xlsx and .doc my line would be as below.

      user_pref("benryan.urlLoaderext", ".xls xlsx doc ");


      Steve

  35. for the MAC, it would be nice to elaborate on the procedure. It seems like one have to drill down into the MAC application package. Would be nice to make it mac friendly. Also, for excel, it does not seem to work with Office 2010 and Firefox 19 on MAC OSX Mountain Lion

  36. Anonymous

    Is there any way to create a distribution of the plugin installation and configuration?  I don't seem to be able to locate the installation files.

  37. Anonymous

    Does not work properly on Mac OS 10.8.4 with Firefox 22, WebDav-Extension 1.0.7, Confluence 5.0.1, MS Office 2011 (14.3.6):

    1. I have to select the executable in the app-package - this is not the way it is supposed to be. It seams that the extension has not actually been tested on a Mac, at least not by a user who knows how Mac OS X works.
    2. Even if I do so, it does not work with Excel - trying to edit an attachment in Confluence, it only opens a blank new file in Excel, nothing more.

    This is rather disappointing (sad) at this time of history of developing a plattform that is supposed to be an enterprise solution, to say the least.

    1. Anonymous

      Especially, since these errors have been reported before here, at the very least since FF16!!!!!!!!

      But no one at Atlassian seems to read our comments (sad)

  38. Anonymous

    I am having the same issue (.xslx) with Confulence 4.3.3 Office 2011 for Mac, and FF 22 webdav 1.07.  I'm sure we are missing some trick as Excel opens but to a blank file.

  39. I have added "docm" to my WEBDav launcher in Firefox, but I still don't get the option to "Edit in Office" the attachments in confluence that end with this extension. Am I doing something wrong? Or is this not possible?

  40. This extension (1.0.7) is broken in Firefox 29.0 .

    1. There is an issue tracking this here  CONF-33469 - Office Connector not working in Firefox 29 and Firefox 30 Resolved

  41. DR

    After reading the comments here, on the CONF-25594 page, and on the Mozilla WebDAV page ( https://addons.mozilla.org/en-us/firefox/addon/webdav-launcher/reviews/ ) I don't know what to do.  We are fairly new to Confluence, and after learning about Office Connector I was initially excited about the capability of editing inserted Office docs and the Confluence page being updated automatically (without the manual gyrations of editing the doc, deleting attachment, removing inserted document, re-attaching and re-inserting edited document - what is the point of Confluence if you have to jump through all those hoops just to revise some content?).

    Now I am not sure if this works, doesn't work, doesn't work with versions of Mac OSX (which many people at our location use), or what.  Plus, on the Mozilla add-on page Atlassian responded to several comments by asking if they were installing from the browser or downloading and installing manually without ever explaining why they were asking that.  (Which is very concerning because we maintain an isolated environment, so I need to download the add-on to our servers and let users install it from there.)  

    So what is the deal Atlassian?  Does the WebDAV add-on work or not?  Does it work with OSX?  Does it work with the latest versions of Firefox? Will it work if I download it to our servers for users to install?  Should I even bother with this?  According to the CONF-25594 page the Mac OSX issue has been known for years.  When will it be fixed? 

    Please respond.