Export or import issue data

Repository administrators can export issues out of or import issues into a Bitbucket Cloud issue tracker. The feature is useful for moving issues between two repositories. You can export issues from one repo and into another. It is possible to write a utility to import data from other issue trackers.  Or, you can write a utility that transforms exported Bitbucket issues for import into another company's issue tracker. Writing either utility would require that you understand the Issue Import/Export Data Format

Import issue data into Bitbucket

Before you begin

  • You need an account with administrative access to the repo.

  • Importing issues into a repository will overwrite existing issues.

  • You cannot "undo" an import.  For this reason, it is a good idea to use the export function to backup an issue tracker before importing.

  • The import feature expects a ZIP file in the correct format. If you are moving issues between Bitbucket repositories, the export feature automatically produces the correct format. 

Steps

  1. Choose a repository and select Repository Settings.

  2. On the left navigation panel select Import & export, which is located under ISSUES.

  3. Under the Import issues section, click Choose file and select the file you want to import.

  4. Press Start import.
    The system displays the import progress. 

    Some Mac OS, and other UNIX based systems, require the following for a successful import Ensure that the db-1.0.json file is at the root of the archive and that any subfolders are also in the root. Generally, this is done using the following:

1 2 cd /path/containing/db-1.0.json zip -r archive-name .

Migrate issues to Jira Software

You can copy the issues existing in a repository into a new Jira Software. If you want to move the issues to an existing Jira project, you have to do it after the copy of the issue is completed by using the bulk issue move.

Before you begin

  • You need administrator permissions for the repository and the Jira site.

  • Only a single issue migration to a Jira site can be running at the same time.

Steps

  1. Choose a repository and select Repository Settings.

  2. On the left navigation panel select Import & export, which is located under ISSUES.

  3. Click Start migration.

  4. Choose the Jira site where you want to create a new project or create a new site. When you’re ready, click Continue.

  5. Enter the project name and key, then click Migrate issues.

Export repository issues from Bitbucket

Before you begin

  • You need an account with administrative access to the repo.

Steps

  1. Choose a repository and select Repository Settings.

  2. On the left navigation panel select Import & export, which is located under ISSUES.

  3. Press Start export.
    The system displays the export progress. When the export is completed, the system displays a dialog with a download link. 

  4. Download the completed zip file.
    The system also sends an email notification containing a link to the download file.

Additional Help