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

WebDAV allows users to access Confluence content via a WebDAV client, such as 'My Network Places' in Microsoft Windows. Provided that the user has permission, they will be able to read and write to spaces, pages and attachments in Confluence. Users will be asked to log in and the standard Confluence content access permissions will apply to the equivalent content available through the WebDAV client.

Mapping a Confluence WebDAV network drive requires a set of specific criteria to be met. For specific information, please see Windows Network Drive Requirements.

Introduction to Confluence's WebDAV Client Integration

By default, all WebDAV clients have permission to write to Confluence. Write permissions include the ability for a WebDAV client to create, edit, move or delete content associated with spaces, pages and attachments in a Confluence installation.

On the 'WebDAV Configuration' screen in the Confluence Administration Console, you can:

Note:

  • The 'WebDav Configuration' page is only available if the WebDAV plugin has been enabled. Note that this plugin is bundled with Confluence, and can be enabled or disabled by the System Administrator.
  • The settings on the 'WebDav Configuration' page do not apply to external attachment storage configuration.

Using a WebDAV Client to Work with Pages

The following sections tell you how to set up a WebDAV client natively for a range of different operating systems. WebDAV clients typically appear as drives in your operating system's file browser application, such as Windows Explorer in Microsoft Windows, or Konqueror in Linux.

Accessing Confluence in Finder on Mac OSX

To use Finder to view and manage Confluence content:

  1. In Finder choose Go > Connect to Server.
  2. Enter your Confluence URL in this format:

    For example if your Confluence URL is http://ourconfluence.atlassian.net/wiki you would enter:

    You must use HTTP, you'll be able to connect with HTTPS but you wont see any content.

  3. Enter your Confluence username and password and click Connect.
    Note: use your username (jsmith), not your email address, unless your email address is your username.
  4. Confluence will appear as a shared drive in Finder.


You can use the same URL to connect using a third party WebDav client, like CyberDuck.

Accessing Confluence in Explorer in Microsoft Windows

This section covers the two methods for configuring a WebDAV client natively in Microsoft Windows:

  • As a network drive
  • As a web folder

If possible, use the network drive method as this will enable more comprehensive WebDAV client interaction with Confluence than that provided by a web folder. However, your Confluence instance must meet several environmental constraints if you use this method. If you cannot configure your instance to meet these requirements, then use the web folder method or third-party WebDAV client software.

If you run into any problems with the procedures in this section, please refer to the WebDAV Troubleshooting page.

Windows Network Drive

To map a Confluence WebDAV client network drive, your Confluence instance must be configured so that all of the following criteria is met:

  • Uses HTTP (not HTTPS)
  • Listens on port 80 (not 8090, the default for Confluence distributions)
  • Has no context root
  • There is an issue (WBDV-208) that can prevent Network Drives from being mapped. Please use the Network Folders steps below as a workaround.

The reason for these restrictions results from limitations in Microsoft's Mini-Redirector component. For more information, please refer to Microsoft's server discovery issue.

To map a Confluence WebDAV client network drive in Microsoft Windows:

  1. In Windows XP, go to My Computer -> Tools menu -> Map Network Drive.
    In Windows Vista, go to Computer -> Map Network Drive.
    The 'Map Network Drive' dialog box opens.
  2. Specify the following input to map the WebDAV client as a network drive:
    • Drive: <Any drive letter> (for example, Z:)
    • Folder: \\<hostname>\webdav (for example, \\localhost\webdav)
  3. Click 'Finish'.
    When prompted for login credentials, specify your Confluence username and password.

Windows Web Folder

To map a Confluence WebDAV client web folder in Windows XP:

  1. Go to My Network Places and choose 'Add a network place'. The 'Add Network Place Wizard' opens.
  2. Click 'Next', ensure that 'Choose another network location' is selected and then click 'Next' again.
  3. In the 'Internet or network address' field, enter the URL for the Confluence WebDAV location (for example, http://<confluence server url>/confluence/plugins/servlet/confluence/default or http://<confluence server url>/plugins/servlet/confluence/default) and then click 'Next'.
    When prompted for login credentials, specify your Confluence username and password.
  4. Provide a meaningful name for your web folder and proceed with the remainder of the wizard.
  5. Click 'Finish'.

Screenshot: A Confluence WebDAV Client Web Folder in Windows XP

To map a Confluence WebDAV client web folder in Windows Vista:
This procedure is very similar to the one for Windows XP. However, the following procedure includes the slight interface differences that are specific to Windows Vista.

  1. Open the 'Map Network Drive' dialog box (refer to first step of the procedure above for mapping a network drive) and choose 'Connect to a Web site that you can use to store your documents and pictures'. The 'Add Network Location' wizard opens.
  2. Click 'Next', ensure that 'Choose a custom network location' is selected and then click 'Next' again.
  3. In the 'Internet or network address' field, enter the URL for the Confluence WebDAV location (for example, http://<confluence server url>/confluence/plugins/servlet/confluence/default or http://<confluence server url>/plugins/servlet/confluence/default) and then click 'Next'.
    When prompted for login credentials, specify your Confluence username and password.
  4. Provide a meaningful name for your network location/web folder and proceed with the remainder of the wizard.
  5. Click 'Finish'.

Setting up a WebDAV client in Linux or Solaris

There are many tools and mechanisms available for configuring WebDAV clients in these operating systems. Therefore, we have chosen to demonstrate this using the file manager Konqueror, which is part of the Linux K Desktop Environment.

To set up a Confluence WebDAV client in Konqueror:

  1. Open Konqueror.
  2. In the 'Location' field, enter the URL for the Confluence WebDAV location using the 'protocol' webdavs (for example, webdavs://<confluence server url>/confluence/plugins/servlet/confluence/default or webdavs://<confluence server url>/plugins/servlet/confluence/default) and press Enter.
    If prompted for login credentials, specify your Confluence username and password.
    You should be able to click to load many, but not all files. In practice, you would normally save a modified file locally, then drag it to the Konqueror window to upload it to Confluence.

Restricting WebDAV Client Write Access to Confluence

In earlier versions of the WebDAV plugin, separate options for restricting a WebDAV client's write permissions (that is, create/move, edit and delete actions), were available. However, in the current version of this plugin, they have been simplified and combined into a general write permission restriction that covers all of these actions.

WebDAV clients are now denied write permission to your Confluence installation by setting a regex that matches specific content within the WebDAV client's user agent header. Upon setting a regex, it will be added to a list of restricted WebDAV clients. Any WebDAV clients whose user agent header matches a regex in this list will be denied write permission to your Confluence installation.

Example: A PROPFIND method header generated by a Microsoft Web Folder WebDAV client, showing the user agent header field:

Note: Unlike earlier versions of the WebDAV plugin which could only restrict write permissions for all WebDAV clients, the current version of this plugin allows you to restrict write permissions to specific WebDAV clients selectively.

To restrict a WebDAV client's write access permissions to your Confluence installation:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Choose 'WebDav Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. Enter a regex that matches a specific component of the user agent header sent by the WebDAV client you want to restrict.
  4. Click the 'Add new regex' button. The regex is added to the list of restricted WebDAV clients.
    You can repeat steps 3 and 4 to add a regex for each additional WebDAV client you want to restrict.
  5. Click the 'Save' button to save the configuration changes.

To restore one or more restricted WebDAV client's write access permissions to your Confluence installation:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Click 'WebDav Configuration' under 'Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. Select the regex(es) from the list that match(es) the user agent header sent by the restricted WebDAV client(s) you want to restore.
  4. Click the 'Remove selected regexes' button. The regexes you had selected are removed from the list of restricted WebDAV clients.
  5. Click the 'Save' button to save the configuration changes.

Screenshot: WebDAV configuration
 

Disabling Strict Path Checking

If you observe any idiosyncrasies with your WebDAV client, such as a folder that does exist on your Confluence site but is missing from the client, you can disable the WebDAV plugin's strict path checking option, which may minimise these problems.

To disable the WebDAV plugin's strict path checking option:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Click 'WebDav Configuration' under 'Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. Clear the 'Disable strict path check' check box.
    (info) You can re-enable this option at a later point in time by simply selecting this check box.
  4. Click the 'Save' button to save this configuration change.

Virtual Files and Folders

In the unlikely event that you observe any problems with the WebDAV client's performance or stability, you can enable access to automatically generated (that is, virtual) files and folders.

Note:

By default, these options are hidden on the 'WebDAV Configuration' page. To make them visible, you must append the parameter ?hiddenOptionsEnabled=true to the end of your URL and reload the page. For example:

Screenshot: The Hidden Virtual Files and Folders Option
 

To enable or disable access to virtual files and folders:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Click 'WebDav Configuration' under 'Configuration' in the left panel. The 'WebDAV Configuration' page is displayed.
  3. Amend your URL as described in the note above and reload the 'WebDav Configuration' page.
  4. Select or clear the check box options in the 'Virtual Files and Folders' section as required.
  5. Click the 'Save' button to save the configuration changes.

Known Issues

Please refer to the WebDAV plugin documentation for a description of the known issues and suggested workarounds.

26 Comments

  1. Anonymous

    Windows 7 allows you to use the port 8090 for exampe to conntect to wedav. For that you have to enter webdav path like as \\wiki.myserver.com@8090\webdav (file://\\wiki.myserver.com@8090\webdav)

  2. Anonymous

    Another way to do it in Windows 7 is to map a drive to \\<wikiserver>@portnumber\DavWWWRoot\plugins\servlet

    For example, assume that the wiki server is accessible from http://mywiki:8082. Therefore, the drive letter should map to

    \\mywiki@8082\DavWWWRoot\plugins\servlet

    -Aoyon (aoyon at cade(remove_this)nce dot com)

  3. Anonymous

    for Win 7 install Software Update for Web Folders (KB907306)

    http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=15123

  4. Anonymous

    It says "In the 'Internet or network address' field, enter the URL for the Confluence WebDAV location."  How do I find out what that URL should be?  It doesn't show it on the 'WebDAV configuration' page.  I tried the examples above (substituting my own host name), but just get errors connecting.

  5. For me with Windows 7 it worked with this URL http://<confluence server url>/plugins/servlet/confluence/default or if you have ssl enabled https://<confluence server url>:portnumber/plugins/servlet/confluence/default

  6. Anonymous

    To map this on "Windows 7" where your instance in on "https"

    You need to use the following URL

    follow the usual login procedures after that.

     

  7. Since you're reading this page, you might be interested in editing Confluence 4 page source in an external XML editor (for example, among many others, Altova XMLSpy), rather than using either the Confluence rich text editor or the Confluence Source Editor plugin.

    If so, you might be interested in reading my comments on the Confluence Storage Format page, where I describe how to wrap the XML snippet of page source served by the WebDAV plugin in a root element, so that it can be validated as an XML document, and edited in a validating XML editor. I also provide a link to a draft DTD that I have developed (in the absence of a schema/DTD from Atlassian).

    1. Anonymous

      Thank you. Yes, that was exactly why I was here and your page is most interesting.

  8. I had problems setting up Windows Web Folder to connect to WebDAV on Windows 7. It is a known issue as described in: https://studio.plugins.atlassian.com/browse/WBDV-229

  9. What happened with Mac OS X How To? It was on the previous version's documents, but not it is gone.

    Is it intensionally deleted?

    Anyway, I can't connect with Mac OS X 10.8, it keeps asking my credential forever from finder.

    Safari shows proper directory list.

     

    1. Hi ChangJoon Lee, I am also seeing a similar problem with finder on OSX 10.8. If it remains a problem for you, can you make an issue in https://ecosystem.atlassian.net/browse/WBDV

      1. Hi, Joe Xie [atlassian]

        Michael Seager [Atlassian] created  CONF-27328 - Unable to connect with WebDav on OS X 10.8.x or Windows 7 Resolved .

        Do you still want me to create an issue in WBDV@ECO?

        Thank you!

        1. No, that's fine - no need for you to make another issue if it's already there.

  10. Anonymous

    We had lots of problems with WebDAV and now discovered this GoEdit-Plugin for Confluence to edit attachments which works right from the start: https://marketplace.atlassian.com/plugins/de.kontextwork.goedit

    Best of all we can use it also for other programs than office like Mindjet, Photoshop, even our CAD colleagues now use GoEdit to edit their files on confluence. For those having problems with WebDAV and like us have to support different Browsers (IE, Firefox, Safari) and operation systems (Windows, OS X, Linux) I really recommend taking a look at this plugin!

  11. Is it possible to get the webdav folders to follow the Confluence permissions? allowing anonymous access for example

     

  12. The documentation says to do a mapped drive use \\<hostname>\webdav. This does not seem to work. However, this does work for me \\<hostname>\DavWWWRoot\plugins\servlet\confluence. So, if you are having trouble with mapping it to a drive letter try this.

  13. If you are on Windows Server 2003 you might need to install a patch to allow WebDav as it is not installed by default.

    http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=15123

  14. Hi, I tried this with the On Demand Confluence and Windows 8.1. But I can't get it to work... Is there any trick to this, that is not yet posted on this site?

    What is wrong with

    \\mysubdomain.atlassian.net\webdav

    ? Any of the port issues above didn't get me any further either.

  15. Hi,

    What is the authentication method for this plugin,  HTTP Basic Authentication or Digest Authentication?

    Thank you!!


     

  16. On linux mint, it's as simple as typing:

    nemo davs://confluence-host/plugins/servlet/confluence/default

  17. Hi All,

    Please, tell me, is it possible for admins to completely hide text file with page's content from WebDAV share, like it is possible with urls, exports and versions? If it isn't possible now, let's add this possibility in future versions of Confluence?

    Here is my thoughts about history of this feature and its current status: 

    1. Feature to make pages content editable as text files in WebDAV share was implemented when pages was in Wiki-format and it was easy to manually create page (Confluence 2.7). But NOW pages have complex XML-based, non-human-friendly format, so creating and editing pages direclty in WebDAV share looks unused option, and this possibility have meaning only for auto-created pages by, for example, robots or build-system, and NOT by hand.
    2. WebDAV is still very useful in working with attached documents, especially because it is possible to mount Confluence WebDAV as a Windows network folder. It is very convenient to modify file as it was local.

     

    1. You will only see that which you have access to in Confluence. So, if you don't have permissions to a space,or a page has a viewing restrictions you won't see it in WebDAV.

      1. Sure, but the question is not about access permissions. I told about an ability to manually edit text files with non-human-friendly format, based on XML. Than you have permission to edit pages. Files with xml inside are hard to edit by hand and should be a possibility to hide these text files from users.

        In case of users who want to post pages this way (for ex. automatically), there will be an option to show files.

  18. Hi Denis, just curious, how do you hide urls, exports and versions ?  I'm not aware that this is possible (at least not up to 5.4.4), but I would like such a feature if this is possible to do.

    1. Hi Hans-Peter, I did it using advanced option ?hiddenOptionsEnabled=true described in this article. And it is available in Confluence 5.3.4.

  19. The Windows Network Drive Requirements state "Uses HTTP (not HTTPS)".  What if you've configured your site to support both protocols?  Wouldn't it continue to work via http?