Import a Confluence Space

This page is about importing a space, rather than a whole site. If you're looking to import an entire site, replacing all content and users in your Confluence Cloud site, see Migrate from Confluence Server to Cloud.


On this page, we'll use the term 'source Confluence site' or 'source site' to mean the Confluence instance you're copying the information from.

Before you start

If your Confluence site also has Jira

Linking spaces to Jira projects. 

You can link a Confluence space to a Jira project when importing a space by selecting the project from the Link to Cloud project dropdown on the import screen.




Importing or migrating your Jira project at the same time? 

If you are also importing or migrating a Jira project that is linked to your Confluence space, please complete the Jira import before you import your Confluence space. This is so that Confluence can update any Jira macros to pull the Jira data from the new location.

Changing space keys

You can't change space keys in Confluence. If it is important to you to have a different space key, you can create a new space with a different key, move your pages into that space, and then import the new space.


The space importer does not overwrite existing spaces, so if your Confluence instance already has a space with the same space key as a space you are trying to import, Confluence will not be able to import that space.


Step 1. Ensure your source Confluence site is the required version

If the source site is another Confluence Cloud site, you can skip this step and move to step 2. There is no need to check the version.


Confluence Cloud accepts site and space imports from Confluence Server instances running version 5.10.x or later. If your instance is running an earlier version, you'll need to upgrade it before completing the site or space export.


If you need to import a space from an earlier version you have two options: 


Option 1. Upgrade a temporary site (recommended) Option 2. Upgrade your source Confluence site
  1. Make a full Confluence site backup (XML export) from your source Confluence site.
  2. Download the latest Confluence version.
  3. Install the new Confluence version into a temporary site.
  4. Import the full backup into the new temporary site.
  5. Continue to the following steps. From this point onwards, the 'source Confluence site' is your temporary site.
  1. Download the latest Confluence version (or choose a specific version, as long as it is 5.10 or later).
  2. Upgrade your source Confluence site to this version (see Upgrading Confluence to find out the best upgrade path for your site).
  3. Continue to the following steps.

Step 2. Export the space content from the source Confluence site

Export the space you want to copy:

  1. Go to your source site and select the space
  2. Click on the space name in the sidebar and choose the cog icon ()
  3. Choose Content Tools > Export
    (info) This option will only be visible if you have the 'Export Space' permission.
  4. Select XML and hit Next

For detailed instructions, please refer to Export Content to Word, PDF, HTML and XML.


If you're using a mac to download the XML export of a space, OS X will unzip the backup, place the unzipped folder in your downloads folder, and put the zipped backup in the trash. In this case, you should retrieve the zip from the trash and upload it to be imported into Confluence.

If you try to upload the unzipped folder, or if you try to re-zip the folder on a mac, you won't be able to successfully import and you'll get an error saying that Confluence can't find the exportDescriptor.properties file.

Step 3. Import the space content into Confluence Cloud

  1. Log in to your Confluence Cloud site
  2. Select Settings in the Confluence sidebar
  3. Choose Import Spaces under 'Administration' in the left-hand navigation bar
  4. Specify your file using the Browse button
    If you're using Jira Cloud, you can also specify the Jira project you'd like to link to this space.
  5. Choose Import

If you're importing more than one space, once the first import has been completed, you can click Import another space and repeat as often as necessary until all your spaces have been imported.

Once you've imported all your spaces, hit Next Step. This will trigger the Jira macro repair, which will find and fix any broken Jira macros on your instance. 

Notes about the space import

  • Users – The above procedure will not import user accounts. See Integrate with G Suite.
  • Groups and permissions – The above procedure will not import any groups that may have been granted specific space permissions in your source Confluence site. This means that if there are pages that are restricted to these groups, you may not be able to see them until you recreate these groups in your destination site. 
  • Importing spaces exported with the Documentation theme – If you have exported a space that was using the documentation theme, make sure you make a note of any wiki markup customizations you may have made to the theme, as these will not be automatically applied to the default theme when the space is imported.
Last modified on Feb 14, 2018

Was this helpful?

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