• Products
  • Documentation
  • Resources

Determine your user migration strategy

When planning your overall migration, it’s important to decide when and how you will migrate users. This will depend on:

  • the products you’re migrating

  • whether you have users from external directories, which might require additional products in cloud

  • if you plan to use Atlassian Access for SCIM user provisioning

We recommend taking the time to learn how user management works in cloud, and make a detailed plan of the tasks you’ll need to complete to migrate your user accounts. We recommend you think holistically about your cloud organization, and how changes to someone’s Atlassian account can affect all cloud products they have access to, not just those managed by your team.

User migration journey

Before you start, check the list of tasks you’ll go through in your user migration, including planning and preparing, and setting up cloud user management.

Get started with migrating users to Atlassian Cloud

User management differences in cloud

User management works differently in cloud. Understanding the basics will make your migration much easier. You’ll also get an idea on whether you need additional subscription to Atlassian Access.

How user management works in Atlassian Cloud

Activating your cloud migration trial

Cloud migration trials are cloud subscriptions equivalent to your current server license. They match your remaining license period in server and your current user tier, which will help you test or run actual migrations without extra cost.

Learn how to activate your Cloud migration trial

Pre-migrating users and groups before data

As part of the lift and shift strategy, we recommend that you pre-migrate users and groups. This is especially important for instances with over 2,000 active and inactive users. When you migrate users separately, we’ll later only migrate the differences, which will significantly speed up your subsequent data migrations.

To migrate users and groups separately, you’ll need to migrate all of them. If that’s not something you want to do, you can still choose to migrate a subset of users together with projects or spaces.

For all teams with over 1000 users, we strongly recommend working with a Cloud specialized partner to help with user and data migration. Learn more about finding a migration partner

User migration options: All or a subset of users

We recommend to migrate all users, but you can still choose to migrate only a subset, especially if you have a smaller instance.

Here are some details on migrating users with the assistants:

Jira

You can use the Jira Cloud Migration Assistant to:

  • Migrate users related to the projects you select to migrate

  • Migrate all users from active internal and external directories without any project data

For Jira Service Management, the assistant can migrate customer accounts related to selected projects, or migrate all customer accounts without any project data.

Learn how to migrate with the Jira Cloud Migration Assistant

Confluence

You can use the Confluence Cloud Migration Assistant to:

  • Migrate users related to the spaces you select to migrate (without groups)

  • Migrate all users from active internal and external directories without any space data

When you select Users related to selected spaces, groups aren’t migrated. Only users who have commented on the page, created pages inside the space, have permissions to access the space, and users who are mentioned on the page are migrated. These users will be added to your cloud site, however, they will not have product access.

Learn how to migrate with the Confluence Cloud Migration Assistant

Bitbucket

For Bitbucket, the Bitbucket Cloud Migration Assistant can add your users to the Bitbucket Migration Users group in Bitbucket Cloud. Note: The migrated users will not have access to anything within Bitbucket Cloud. You will need to create groups or move them to existing groups and provide the migrated users with the necessary access and permissions to any repositories or other content in Bitbucket Cloud.

Learn how to migrate with the Bitbucket Cloud Migration Assistant

How users and groups are migrated

Here are some details on how exactly we migrate users and groups.

Learn how Jira users and groups are migrated

Learn how Jira Service Management customers are migrated

Learn how Confluence users are migrated

Get started with your user migration

When you’re ready, check the tasks related to user migrations.

Get started with migrating users to Atlassian Cloud

Additional Help