• Products
  • Documentation
  • Resources

What gets migrated with Bitbucket Cloud Migration Assistant

The Bitbucket Cloud Migration Assistant (BCMA) will add data to a Bitbucket Cloud workspace without overwriting any existing data. This means you can migrate data to a new or existing Bitbucket Cloud workspace. Not all data can be migrated using the Bitbucket Cloud Migration Assistant.

This page outlines what is and isn’t migrated with the migration assistant. To see what this means for your data, we recommend using the migration assistant’s pre-migration report to check what will be migrated. This can be found under the Review and Migrate section when building a new plan. It can also be found within the View Details of a saved plan under the View Errors and Warnings section.

What is migrated

What isn't migrated

Repository Git information

  • If your repository is part of a project in Server, then The Git repository (including all branches, tags, and commits) will be migrated to a new project with the server project name or added to a project of the same name that already exists in your cloud destination.

Pull request information

  • Title

  • Description

  • Pull request status (open, merged, declined)

  • Code diff, comments, tasks

  • Authors

  • Reviewers


  • Choose which users to migrate:

    • All users

    • Users with read access or who appear on selected repositories

    • Only users who appear on the selected repositories

Atlassian administrated workspaces only

For information on how to obtain a Bitbucket Cloud workspace in your organization in Atlassian Administration, refer to our help documentation.


Choose which groups to migrate:

  • All groups

  • Only groups with users and permissions selected for migration

  • Do not migrate any groups


Choose which permissions to migrate:

  • Copy permissions of all users and groups

  • Do not copy any permissions

Branch permissions & branch modeling

  • Choose whether or not to migrate any branch permissions and branching models

Repository Git information

  • Migrating the link or association of forked repositories

    • NOTE: The forked repo can be migrated but it will lose its link or association and be treated as a normal repo if migrated. We recommend merging any open pull requests from forks prior to migrating to the cloud to prevent any data loss.

  • Content stored in Git LFS

    • NOTE: Git LFS can be migrated manually afterward. You will need to install and set up Git LFS on your repositories in Bitbucket Cloud. Learn more

  • Git submodules

    • NOTE: Specifically, the extra configuration within the code base (in a .gitsubmodules file) is not automatically updated. This file contains the links to other repos that will need to be updated by a customer/partner either before or after migrating.

  • Pull request attachments

  • Repos with duplicate names

  • Open changes on local machines

  • Extra large repos (max is currently 10GB)

  • Personal repos

    • NOTE: As a workaround, we recommend moving these to normal projects first so they can then be migrated.

  • Repo settings:

    • Add default reviewers

    • Branch permissions

    • Managing webhooks

    • Merge checks

    • Build statuses

User metadata

  • Groups - Bitbucket administrated workspaces only

  • Permissions - Bitbucket administrated workspaces only

  • Settings

  • Avatars

  • Passwords

  • Timezones

  • SSH keys

  • App passwords

Project data

  • Settings

  • Permissions - Bitbucket administrated workspaces only

Apps and app data

  • App data is not included when migrating from Bitbucket Server to Bitbucket Cloud using BCMA. Some apps do have the capability to export and import their data (outside of BCMA scope) but you'll need to check with the app developers or their documentation to confirm if this is possible.

Atlassian administrated workspaces only

For information on how to obtain a Bitbucket Cloud workspace in your organization in Atlassian Administration, refer to our help documentation.

Issue tracker and wikis

  • Wiki and Issue Tracker features are not supported in workspaces administered through admin.atlassian.com. These features will be disabled if you are migrating to a workspace administered through admin.atlassian.com. If you have already migrated the repository, you can still go back to that repository in your Server or Data Center instance to regain access to the wiki and issues. Wikis can be exported via cloning since they are stored as a separate repository. Issues can be exported as a zip file or migrated to Jira.

More information and support

To stay informed about the work being done on the migration assistant, keep an eye on our cloud migration roadmap.

We have a number of channels available to help you with your migration:

Still need help?

The Atlassian Community is here for you.