Plan your Cloud migration
Documents to help you prepare to migrate your Atlassian Server products.
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.
Before finalizing your migration plan, we recommend choosing a user migration method that works for your set up, especially if you’re using a third-party identity provider. Learn more about user migration strategies
With the Confluence Cloud Migration Assistant, you have two options for migrating your users and groups:
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:
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. |
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.
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
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.
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
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.
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
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
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.
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.
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.
Was this helpful?