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.

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
	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
	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:

• Users and groups: How Confluence users and groups are migrated

• Apps: App assessment and migration

Migrate spaces

To add spaces to your migration:

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

2. Select the spaces you want to migrate.

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:

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:

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