• Products
  • Documentation
  • Resources

Migrate data using the Confluence Cloud Migration Assistant

When migrating Confluence, you build a migration plan and fill it in with data. You can either include everything in a single plan or divide it into many migration plans.

Looking for information on assessments?

You can find information on app and user assessments in these collections:

Before you begin

Complete these steps:

  • Check what can be migrated with this option. Learn more

  • Update the assistant and allowlist required IPs and domains. Learn more

  • Check for possible data conflicts to avoid issues. Learn more

  • Complete the pre-migration checklist to prepare your environment. Learn more

  • Pre-migrate users, groups, and attachments before other data to reduce downtime. Learn more

Permissions:

  • To migrate, you need to be an admin in both the source instance and the destination cloud site.

Create a migration plan and connect to your cloud site

To create a migration plan:

  1. Open the Confluence Cloud Migration Assistant.

  2. Select Create new migration.

  3. On the Connect to your cloud site screen, provide the following data:

Example screen

Fields

"Connect to your cloud site" screen in the assistant.
  • Name your migration

  • Choose migration stage: production or testing. This option doesn’t affect your migration. It will help you recognize different migrations plans on the dashboard.

  • Choose destination cloud site: If you don’t have one yet, you can activate your free Cloud migration trial and create one.

Once you select a destination cloud site, you’ll be able to choose what to migrate.

Choose what data to include in your plan

You can add the following items to your migration plan.

Example screen

What you can migrate

Data that can be added to your Confluence migration plan, for example spaces.
  • Spaces (and their attachments)

  • Attachments only

  • All users and groups from the Confluence directory, or only users related to the spaces you’re migrating in the same plan

  • All apps that you marked as Needed in cloud when assessing your apps

How each data type is migrated

Check how each data type is migrated and what are the best practices:


Migrate spaces

To add spaces to your migration:

  1. In the Spaces section, choose one of the following options:

Option

Description

Migrate spaces

Migrate all selected Confluence spaces.

Migrate attachments only

Migrate only attachments from the selected Confluence spaces.

Skip spaces

Don’t migrate any spaces.

2. Select the spaces you want to migrate.

List of Confluence spaces that can be added to a migration plan.

3. When you’re ready, select Add to migration.


Migrate users and groups

To add users and groups to your migration:

  1. In the Users and groups section, choose one of the following options:

Option

Description

Migrate all users and groups from the Confluence directory

Migrate all users and groups from your Confluence users directory.

If you’re looking to speed up your migration, this option is faster. When migrating only a subset of users, the assistant needs to check them against every space in Confluence, which takes time.

Migrate users related to the selected spaces

Migrate only users that are referenced in the spaces you added to your migration plan, which includes users who:

  • Commented on a page

  • Created pages inside the space

  • Have permissions to access the space

  • Are mentioned on a page

When you choose this option, we always migrate some data connected to the spaces you’re migrating. This is to ensure that all mentions, comments, and page history stay active.

Skip users

Don’t migrate any users and groups.

2. When you’re ready, select Add to migration.


Migrate apps

To add apps to your migration:

  1. In the Apps section, choose one of the following options:

Option

Description

All

Migrate all apps that you marked as ‘Needed in cloud’ when assessing and preparing apps, and that have a migration path provided by the app vendor.

None

Don’t migrate any apps.

2. When you’re ready, select Add to migration.


Next steps

Once you’re done, check for errors in your migration. Learn how to check for errors in your migration plan

Additional Help