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

You can export part of, or the entire contents of, a Confluence space into a zipped archive of XML files and attachments. This is useful if you want to make a backup of the space, or import the space into another Confluence site, or use the data from the space in another application.

To export a space or pages to XML, you need the 'Export Space' permission. See Space Permissions.

Notes:

To export pages or an entire space to XML:

  1. Go to the space and choose Space tools > Content Tools on the sidebar. 
  2. Choose Export 
    Note: This option will only be visible if you have the 'Export Space' permission.
  3. Select XML then choose Next.
  4. Decide whether you need to customise the export:
    • Select Full Export to produce an XML file containing all the pages in the space, including those that you do not have permission to view.
    • Select Custom Export if you want to export a subset of pages, or to exclude comments from the export.
  5. Select Include Comments if you want to include comments made on the pages you are exporting.
  6. Select the pages you want to export.
    • You have the option to Select All or Deselect All pages.
    • When you select a page, all its child pages will also be selected. Similarly, when you deselect a page all its child pages will also be deselected.
  7. Choose Export. This will create a zipped archive of XML files and attachments.
  8. When the export process has finished, download and save the zipped archive file as prompted.

If your space uses the Documentation theme:

  1. Choose Browse > Space Operations.
  2. Choose XML Export from the left-hand panel.
  3. Follow the steps above to export the space.

On this page:

Related pages:

Screenshot: Exporting a space


Notes

If you are running Confluence behind Apache HTTP Server and are facing timeout errors, please consider creating the export directly from Tomcat, instead of going through Apache. This will speed up the process and prevent timeouts.

  • No labels

8 Comments

  1. FYI: The temporary location of the .xml.zip file is: [data folder]/temp

    This file is automatically deleted (within hours of its creation, in my experience). Try not to close the browser window/tab that shows the progress bar, because if closed there seems to be no way to reach it again and you won't get a handy download link at the end of the process.

  2. Thank you Saul!  My instance shows 100% complete, but still reads "zipping export files", never providing a download link.  I hope this gets noted someplace other than here.

  3. What about Blog posts? How to export Blog posts? This guide is only useful for Pages!

  4. I'm curious as to the implications of running this export tool. Will running this affect any users in any way?

  5. Anonymous

    is it possible to export users and users spaces seperately?

  6. Is there any WebAPI or shell command to do the export, similar to MediaWiki?

    1. Hi Federico,  you might want to look at the Command Line Interface for Confluence.  We use it for copying and bulk deleting pages, and I believe it is also able to export pages and spaces. 

      1. Hi Rachel, thanks for the tip. In the meanwhile I found out that "Confluence is configured to back up its data automatically, as a zipped XML file" and that XML-RPC and SOAP APIs have an exportSite method since version 1.4. The plugin you mention is freely available only till 4.3 but it looks very easy indeed, just unzip and:

        $ ./confluence.sh --server $DOMAIN --user $NICK --password $PW --action exportSite  --file export.xml
        Remote error: com.atlassian.confluence.rpc.NotPermittedException: You don't have the 'Confluence Administrator' permission.

        Now I only need to know how the XML looks like and see if I can give this permission to all users or it contains private data. Otherwise, as a site admin I can just fetch the file from the backup directory.