Restoring a Space

You can export a space, including pages, comments and attachments, to a zip that contains an XML file and, optionally, all the attachments in the space. To import the space to another Confluence site, restore the zip 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 only accepts 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.

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.

On this page:

Related pages:

Also, Confluence won't allow you to import a space if there's already a space with the same space key. If you already have a space with the same key, you'll 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 restore directory and restore it from there. We recommend the second option for large backup files.

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. Select the zip file that you copied in step 1 from the list of files under the heading Restore a backup from the Confluence Home Directory
  5. Uncheck Build Index if you want to create the index at a later stage
  6. Choose Restore

Workaround for restoring spaces from Confluence 5.3 and below

If you need to import a space from a version prior to Confluence 5.3, 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 the same version as the site where you want to import the space (see Upgrading Confluence for instructions)
  5. Export the space from your temporary Confluence site (it'll now have the right 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