Set up Confluence Cloud
Get the high-level details you need to set up your Confluence Cloud site in order to meet your team's needs.
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.
For migrating from Confluence Server to Confluence Cloud, see the Server to cloud migration guide.
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.
On this page, we will use the term 'source Confluence site' or 'source site' to mean the Confluence Cloud site you are copying the information from. The 'destination site' is the Confluence Cloud instance you are copying the information to.
Step 1: Back up your destination Confluence Cloud site
The import will remove all data on your destination site, including content, users, and groups. We strongly recommend you make a backup copy of the destination site and save the backup file on your local file system. To export the contents of your source Confluence Cloud site, follow the steps described in Create a site backup.
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:
Unzip the backup file.
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:
Go to the Confluence download page and get the latest Confluence Server release for your operating system.
Install Confluence as described in the Confluence Installation Guide.
Import the data from your backup file (XML export) into your new Confluence installation. See Restoring a Site in the Confluence Server documentation.
Log in to your new temporary Confluence instance, using the following credentials:
Username: sysadmin
Password: sysadmin
Change the password immediately after logging in.
Export the spaces from the temporary site. See Export Content to Word, PDF, HTML and XML in the Confluence Server documentation.
Import the spaces one by one into the destination Confluence Cloud instance. See Import a Confluence Cloud space.
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.
In your source Confluence Cloud site, choose Settings in the Confluence sidebar.
Choose Site import.
Specify your file using the Browse button.
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.
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.
In the instructions below, the Confluence Cloud site that data is being copied from is referred to as the source site, and the Confluence Cloud site that data is being copied to is referred to as the destination site.
Notify support of your migration window
If you’ll be performing your migration over a weekend or holiday, or are migrating over 1,000 users to cloud, get in touch at least two weeks in advance to let us know. This is so we can ensure we have extra support on hand during your migration. Learn more about how we support cloud migrations
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.
This method may not work for all customers. We recommend that you test this method before performing a production migration. This will help you anticipate the issues that you may encounter during your migration and resolve them in advance.
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:
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.
Create a site backup of Confluence Cloud B. This will contain the users and spaces you want to import to Confluence Cloud A.
Import your data from Confluence Cloud B to Confluence Data Center.
Use the Confluence Cloud Migration Assistantto import your users and spaces from Confluence Data Center to Confluence Cloud A.
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.
We strongly encourage performing a dry-run of the import and doing User Acceptance Testing on a test cloud site(which can be created using a free trial) before proceeding with the import on your production cloud site.
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.
Was this helpful?