Migrate a Confluence Cloud site or merge multiple sites

This page is for people who are currently using Confluence Cloud, and want to move their entire site to a different Confluence Cloud site or merge multiple Confluence Cloud sites.

Migrating a Confluence Cloud site to an existing Confluence Cloud site

When to use this method

• When you want to move from an existing Confluence Cloud site to another Confluence Cloud site.

• When your new cloud site is Confluence-only. If you have both Confluence and Jira in your Cloud site, you’ll need to import all of your spaces individually. See Import a Confluence Cloud space for information on how to do that. 

Before you begin

This process will replaces all content and users from your Confluence Cloud site, including:

• The content of all spaces exported from the other site.

• The users exported from the other site, including all administrators and non-administrators.

• The groups, and user memberships of those groups, exported from the other site.

Step 1: Back up your destination Confluence Cloud site

Before you back up your site, make sure all user accounts have a unique email address associated with them. If this isn't done, the import will fail. If you started an import and noticed that it imported all the data, and then failed, this may be the cause.

Step 2: Export the site content from the source Confluence Cloud site

To export the contents of your source Confluence Cloud site, follow the steps described in Create a site backup.

• Remember to include attachments in your backup

• Make sure all user accounts have a unique email address associated with them

Step 3: Check the size limits

Site import in Confluence Cloud is restricted to a maximum 200 megabytes for the uncompressed XML files inside the backup zip file. This is the 'data size' of the backup. There's no limit to the file size and number of attachments.

When you try to do the import, Confluence Cloud will inform you if the backup data is too large.

To manually check the data size of the backup:

1. Unzip the backup file.

2. Sum the sizes of the XML files in the root directory of the zip file (this will be at least the file named entities.xml and may also include XML files added by plugins).

What if the data size is okay?

If the data size of your site backup file is within the limits, import the site backup directly into the destination Confluence Cloud instance. See below.

What if the size limit is exceeded?

If the size of your site backup file is too large, you'll need to move the content space by space and ensure your user data is imported, too. This involves exporting each space individually. You can do this in your Cloud site, or using Confluence Server. 

If the source site is a Confluence Cloud instance, you can copy your data to a temporary installed site running Confluence Server 5.10 or later so that you can create the space exports:

1. Go to the Confluence download page and get the latest Confluence Server release for your operating system.

2. Install Confluence as described in the Confluence Installation Guide.

3. Import the data from your backup file (XML export) into your new Confluence installation. See Restoring a Site in the Confluence Server documentation.

4. Log in to your new temporary Confluence instance, using the following credentials:

   • Username: sysadmin

   • Password: sysadmin

5. Change the password immediately after logging in.

6. Export the spaces from the temporary site. See Export Content to Word, PDF, HTML and XML in the Confluence Server documentation.

7. Import the spaces one by one into the destination Confluence Cloud instance. See Import a Confluence Cloud space.

8. Import your users. See Connect to Google Workspace.

Step 4: Import the site content into your source Confluence Cloud site

If the data size of your site backup file is within the limit described above, import the site backup directly into the destination Confluence Cloud instance.

1. In your source Confluence Cloud site, choose Settings in the Confluence sidebar.

2. Choose Site import.

3. Specify your file using the Browse button.

4. Choose Import.

Apps

After migrating your data, you'll need to re-install any compatible apps, like Questions for Confluence and Team Calendars for Confluence.

You can check whether your essential apps are available for Confluence Server, Cloud or both on the Atlassian Marketplace.

For migrating from Confluence Server to Confluence Cloud, see the Server to cloud migration guide.

Merging Multiple Confluence Cloud Sites

Confluence Cloud does not support merging multiple sites, although that work is on our roadmap. You can watch this request for updates: CLOUD-11495 - Confluence Cloud to Cloud migration tooling IN PROGRESS. Workarounds are available. The workaround you choose depends on your needs, including how many Confluence sites you want to merge.

• To merge two sites, we recommend using a Confluence Data Center instance to facilitate the merging process. This is the simplest way to maintain your set up and configuration and only requires downtime for one of your cloud sites.

• To merge three or more sites, follow the instructions toimport a Confluence Cloud spaceto an existing cloud site.

Merging two Confluence Cloud sites

This method requires setting up a Confluence Data Center instance. You’ll need to create a backup of the data from your source cloud site, restore this backup in the Data Center instance, and use the Confluence Cloud Migration Assistant to import the data into your destination cloud site. You can use this method to consolidate two cloud sites or move specific spaces from one Confluence Cloud site to another.

This is the simplest way to maintain your setup and configuration and only requires downtime for one of your cloud sites.

Instructions

Customers with two Confluence Cloud sites can move all or some spaces from one site into the other in order to have a single, consolidated site.

This method requires setting up a Data Center instance.

To merge sites:

1. Install the latest version of Confluence Data Center. You can do this by generating a free trial license from my.atlassian.com. Note that Confluence Data Center trial licenses last for 30 days. If you need more time to complete your migration, licenses can be extended to 90 days upon request.

2. Create a site backup of Confluence Cloud B. This will contain the users and spaces you want to import to Confluence Cloud A.

3. Import your data from Confluence Cloud B to Confluence Data Center.

4. Use the Confluence Cloud Migration Assistantto import your users and spaces from Confluence Data Center to Confluence Cloud A.

Limitations

• App data isn’t supported. After migrating your data, you’ll need to re-install any apps you need in the cloud.

• Some configurations might not be supported. Before choosing this method, check what gets migrated with the Confluence Cloud Migration Assistant.

• Knowledge of how to install and set up a Confluence Cloud Data Center instance is required.

Merging three or more Confluence Cloud sites

The method outlined above using a Confluence Data Center instance is only suitable for merging two Confluence Cloud sites.

To merge three or more sites, follow these instructions to import a Confluence Cloud space to an existing cloud site.