Back up a Space or multiple Spaces

You can export a single space or multiple spaces to an XML backup in the Confluence administration console.

Multi-space backup is helpful when you want to export a large site in smaller batches or generate a backup based on a team, project, or topic.

You'll need System Administrator permissions to do this.

A single space XML backup can also be generated by Space Admins in Space tools.

Good to know:

  • You can't restore a multi-space XML backup into an earlier version of Confluence.

  • You can’t restore a multi-space XML backup to Confluence Cloud either. Use the Confluence Cloud Migration Assistant app to do this. This is pre-installed with your Confluence installation.

What’s included in a space backup (export)?

A space backup includes, but is not limited to:

  • pages
  • blogs
  • comments
  • attachments
  • drafts

Basically, it’s everything in your space. 

Create a single or multi-space backup (export)

To create an XML backup of one or more spaces:

  1. Go to Administration  > General Configuration > Backup and restore
  2. Select Back up site or spaces
  3. In the Create a backup screen:
    1. Select Spaces
    2. Select the spaces you want to include in your XML export file. You can type the name of a space, or select recent spaces from the dropdown menu.
    3. Give your XML export a file name prefix. Confluence will add a time stamp and unique identifier to the end of this file name. If this field is left blank, the file will be assigned a default prefix and time stamp, for example, for single spaces Confluence-space-export-<SPACE KEY> or for multi-space backups, Confluence-space-export-<NUM SPACES>
    4. Select Save permanently if you want your file to remain in the <confluence-home>/restore/space folder. Otherwise, the backup will be deleted in 72 hours by default to maintain storage capacity. You can change the storage time by configuring the system property confluence.backuprestore.backup.ttl-in-hours. See Configuring System Properties to learn how.
  4. Select Back up
  5. You will receive a confirmation message, select Back up now to start the task

This process can take some time if you have many large spaces selected.

Retrieve the space backup

Method 1

Once the back up is complete, you can download the XML backup zip file by selecting the file name. This download link is active for 72 hours by default in case you need it later.

Method 2

Confluence will also save the backup as a zipped XML backup file in your<home-directory>/restore/space folder. See Confluence Home and other important directories for more information to locate your home directory. The backup will be deleted from this location after a set amount of time if you did not choose to save it permanently during the back up process.

You'll need access to the Confluence server to retrieve the file this way.

Restore (import) the space backup

There are some restrictions on which Confluence versions you can import your backup into. The most important is that you can't import into an earlier version of Confluence or to Confluence Cloud. See Restore a Space or multiple Spaces for more information and troubleshooting tips. 

Last modified on Dec 7, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.