Restoring a Space

This page tells you how to import the contents of a Confluence space into another Confluence site, via an XML backup file.

You can export the content of a space, including pages, comments and attachments. The process involves converting the data in the space into XML format. The end product is a zip file that contains XML file(s) and optionally, all the attachments in the space. To transfer this data to another Confluence site, restore this zip file as described below.

You need to have System Administrator permissions in order to restore a space from an XML zip file.

Export and import compatibility

Confluence can only accept space exports from compatible versions.

To find out which versions your current Confluence version can accept space exports from go to  > General Configuration > Backup and Restore.

On this page:

Related pages:

You may not be able to import spaces into earlier versions of Confluence, the Backup and Restore page in the later Confluence version will give you some indication of whether it is likely to be compatible.

If you need to import a space from an incompatible version, see the workaround described below.

Additionally, Confluence will only allow you to restore a space if there is not already a space with the same space key on the site. If you already have a space with the same key, you will need to delete the existing space before importing the new one.

Restoring a space from an XML backup

You can restore data from an XML backup file located somewhere on your local computer or a shared drive, or you can copy the XML file into the Confluence installation and restore it from there. The second option is recommended for large backup files. Both options are described below.

To restore data from an XML backup located outside Confluence:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Choose Backup and Restore in the left-hand panel.
  3. Choose Choose File and browse for the backup file.
  4. Uncheck Build Index if you want to create the index at a later stage.
  5. Choose Upload and Restore

To restore data from an XML backup located in your Confluence installation:

  1. Copy your XML backup zip file into the restore directory in your Confluence home directory. For example:
    • On UNIX: /opt/java/src/confluence/deployments/conf.atlassian.com/home/restore
    • On Windows: C:\Program Files\Atlassian\Application Data\Confluence x.x\restore
  2. Choose the cog icon , then choose General Configuration under Confluence Administration
  3. Choose Backup and Restore in the left-hand panel.
  4. The zip file that you copied in step 1 will appear in the list of files under the heading Restore a backup from the Confluence Home Directory on your Confluence Administration Console. Select the zip file.
  5. Uncheck Build Index if you want to create the index at a later stage.
  6. Choose Restore.

Workaround for restoring spaces between major releases

If you need to import a space from an earlier major version, you can use a temporary Confluence installation to upgrade the space export to the right version number:

  1. Download the same version of Confluence as the version you exported the space from. You can get older versions of Confluence at the Confluence Downloads Archive.
  2. Install that version of Confluence on a temporary server.
  3. Import the space into this temporary Confluence site.
  4. Upgrade Confluence on your temporary site to same version as the site where you want to import the space. See Upgrading Confluence.
  5. Export the space from your temporary Confluence site. It will now have the correct version number.
  6. Import the space into your production Confluence site.

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