Import a Confluence Space
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|
Step 2. Export the space content from the source Confluence site
Export the space you want to copy:
- Go to your source site and select the space
- Click on the space name in the sidebar and choose the cog icon ()
- Choose Content Tools > Export
This option will only be visible if you have the 'Export Space' permission.
- 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
Step 3. Import the space content into Confluence Cloud
- Log in to your Confluence Cloud site
- Select Settings in the Confluence sidebar
- Choose Import Spaces under 'Administration' in the left-hand navigation bar
- 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.
- 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.