How Confluence users and groups are migrated

The Confluence Cloud Migration Assistant lets you migrate your Confluence users from Server to Cloud. You can migrate users on their own or with space data.

User migration options

With the Confluence Cloud Migration Assistant, you have two options for migrating your users and groups:

User data migrated with a subset of users

When you choose Migrate users related to the selected spaces, we will still migrate some user data connected to the spaces you are migrating. This is to make sure that mentions, comments, and page history stay active.

User data that will be migrated every time includes:

• full name

• username (discarded after migration)

• email address

We'll only migrate this information for users directly connected to the spaces you are migrating. We'll not give these users product access or add them to any groups. They will appear in your Cloud site user list.

If you choose to migrate users later, their product and group access will be updated.

Also, if you choose not to migrate users and groups and you have a space permission granted by a group that doesn’t exist in Cloud, the Confluence Cloud Migration Assistant will not migrate the respective space permission. To avoid this scenario, we recommend that you create the specific group in the Cloud site before migration.

How user and group data is linked

User accounts in Cloud are identified by unique email addresses.

When using the Migration Assistant to migrate, a new account will be created in your Cloud site for each of your users. If an email address already exists in your Cloud site, it won’t be migrated. Instead, we will link all data connected to that user to their account in Cloud.

If you have users that already exist in your destination Cloud site, then the following will occur:

• if a user has product access in Cloud, but has disabled status in your Server site, they will continue to have product access in Cloud after migration

• if a user does not have product access in Cloud, but is enabled and has product access in your Server site, they will be granted product access through the migration process

Your groups will also be linked to existing groups in Cloud (if they are already there). Group linking is identified by group name and could result in permission escalation during migration. Make sure you check your groups before migrating. Learn how user groups and permissions are migrated

How users from your knowledge base are migrated

If you use Confluence as the knowledge base for Jira Service Management (formerly Jira Service Desk), your Jira Service Management users may also be migrated along with your Confluence users. This will happen if you can see your Jira Service Management users in the cwd_user table in Confluence.

Pre-migrating users and groups to reduce downtime

If you migrate your users before your space data, you will save time on migration day. This is because the Migration Assistant will not need to re-migrate those users. This is particularly helpful if you are migrating all of your users. 

Learn how to migrate Confluence users and groups in advance

Test migrations

For a test migration or User Acceptance Testing (UAT), we recommend that your test cloud site isn't part of the production organization. This is to ensure smooth migration of the relevant users and groups. All sites within a single organization would share the same users and groups.

Deleted or inactive users and directories

Any deleted users or users in inactive directories that are referenced in your Confluence data will appear as Former user after migration. If you need to migrate the references to these users, reactivate them (or the directory) before migrating.

Users with disabled status in your Server instance will be migrated as active but without any product access. This means they will not be counted as active Confluence users for billing purposes. Learn how users are managed in cloud

Permissions and product access

The first time you migrate, you will need to review and approve group permissions after migrating. When you approve group permissions any active users in your Cloud site will be added to your bill.

Global settings and global site permissions are not migrated with this tool. You’ll need to set these manually before or after migration.

Learn how user groups and permissions are migrated

Email notifications

We won’t send an invitation to your users even if you choose to give your users access during the migration. To invite your users you can choose to send an invitation from the Administration space after you have migrated, or send a link for them to log in themselves.

Billing changes in Cloud

Confluence Cloud is subscription-based and billed on a per-user basis. If you plan to migrate your users, make sure you check the licensing options or calculate the cost with our pricing calculator. By default, Cloud subscriptions are billed on a monthly basis however you can choose annual billing if you prefer. 

Third-party identity providers

If you're intending to use an external identity provider in Cloud, make sure you've read the guidance on migrating users and groups. Learn more about user migration strategies

We recommend synchronizing your identity provider with Confluence before migrating. This is to make sure that your users and groups are up to date before you transfer any data.