Migrate from Confluence Server to Cloud

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Before migrating, make sure you take a look at Functional differences in Confluence Cloud to find out about any relevant differences between Confluence Server and Cloud.

You can import all the content from another Confluence instance into your Confluence Cloud instance. This will replace all content and users in your Confluence Cloud instance, 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.

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 want to import content space by space, instead of replacing the entire site, see Import a Confluence Space.

On this page, we will use the term 'source Confluence site' or 'source site' to mean the Confluence installation you are copying the information from. The 'destination site' is the Confluence Cloud instance you are copying the information to.

Multiple cloud apps?

Note: Site import is only available for Confluence-only instances. If you have multiple applications, such as Confluence and Jira, you'll need to export and import spaces individually. See Import a Confluence Space.

Step 1. Back up your existing 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. See Create a site backup.

Before you back up your site, please ensure that all user accounts have a unique email address associated with them. If this isn't done, it will cause the import to fail.

If you started an import operation and noticed that it imported all the data, and then failed, this may be the cause. 

Step 2. Upgrade your source Confluence site

The site importer requires that your source Confluence data is running version 5.10.x or later. If your instance is running an earlier version, you'll need to upgrade it. In order to keep your existing Confluence instance stable, you may want to perform this upgrade on a separate Confluence instance that's running on an evaluation license.

Step 3. Export the site content from the source Confluence site

Here we explain the process of creating an XML export from a Confluence Server instance. 

  1. Choose Settings in the Confluence sidebar.
  2. Choose Backup & Restore in the left-hand panel.
  3. Choose Backup attachments.
  4. Choose Backup.
    After the backup is complete, you'll see the link to the backup file (XML export).

Step 4. 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 size and number of attachments.

When you try to do the import, Confluence 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 OK?

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 data size of your site backup file is too large, you'll need to import the content space by space and ensure your user data is imported, too.

If the source site is a Confluence Cloud instance...

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 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 documentation).
  7. Import the spaces one by one into the destination Confluence Cloud instance. See Import a Confluence Space.

  8. Import your users (See Integrate with G Suite).

Step 5. Import the site content into your 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. Go to your Confluence Cloud site and choose Settings in the Confluence sidebar.
  2. Choose Site import.
  3. Specify your file using the Browse button.
  4. Choose Import.


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

(warning) Please note that at present, there is no way to migrate your Questions for Confluence and Team Calendars for Confluence data from Server to Cloud. 

Some third-party add-ons are only available for Server, and will no longer be available after you migrate. You can check whether your essential add-ons are available for Confluence Server, Cloud or both on the Atlassian Marketplace

Last modified on Feb 28, 2018

Was this helpful?

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