GitLab Documentation

Import your project from Bitbucket to GitLab

Import your projects from Bitbucket to GitLab with minimal effort.


Note: The Bitbucket integration must be first enabled in order to be able to import your projects from Bitbucket. Ask your GitLab administrator to enable this if not already.

How it works

When issues/pull requests are being imported, the Bitbucket importer tries to find the Bitbucket author/assignee in GitLab's database using the Bitbucket ID. For this to work, the Bitbucket author/assignee should have signed in beforehand in GitLab and associated their Bitbucket account. If the user is not found in GitLab's database, the project creator (most of the times the current user that started the import process) is set as the author, but a reference on the issue about the original Bitbucket author is kept.

The importer will create any new namespaces (groups) if they don't exist or in the case the namespace is taken, the repository will be imported under the user's namespace that started the import process.

Importing your Bitbucket repositories

  1. Sign in to GitLab and go to your dashboard.
  2. Click on New project.

    New project in GitLab

  3. Click on the "Bitbucket" button


  4. Grant GitLab access to your Bitbucket account

    Grant access

  5. Click on the projects that you'd like to import or Import all projects. You can also select the namespace under which each project will be imported.

    Import projects

Leave a comment below if you have any feedback on the documentation. For support and other enquiries, see getting help.