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.  Importing issues destroys existing issues in the tracker.

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. 

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

How to Import 

You can import any ZIP file Log into Bitbucket Cloud using an account with administrative access to the repository. Then, do the following:

  1. Press the repository settings   icon.
    The repository settings page appears. 
  2. Select the Import & Export link from the left-hand navigation.
  3. Choose an archive file to upload.
  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:

How to Export 

Log into Bitbucket Cloud using an account with administrative access to the repository. Then, do the following:

  1. Press the repository settings   icon.
    The repository settings page appears. 
  2. Select the Import & Export link from the left-hand navigation.
  3. Press Start export.
    The system displays the export progress. When the exports completes, 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. 

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport