Importing data from Bitbucket

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The Jira Bitbucket Importer plugin is no longer supported. We recommend you use the JSON importer instead.

Prepare your issues for import from JSON

Export your issues from Bitbucket, then complete the following steps to get your JSON file ready for import into Jira.

1. Wrap the issues attribute inside a projects object

The projects object you add will need the following attributes:

  • name – The name of the Jira project you're creating to import the issues into
  • key – The unique key you want to use for the Jira project you're creating
  • description – A description for the project
  • type – "business", "software", or "service-desk" depending on the type of project you're creating
  • template (only if "software" is specified as the type) – For SCRUM, the template should be "com.pyxis.greenhopper.jira:gh-scrum-template"; for KANBAN, the template should be "com.pyxis.greenhopper.jira:gh-kanban-template". You can get the full list of templates from this private API:


"projects": [
            "name": "A Sample Project",
            "key": "ASM",
            "description": "A description of the project",
            "type": "software",
		  "issues": [
		      "status": "To Do",
		      "priority": "major",
		      "kind": "bug",
		      "content_updated_on": null,
		      "voters": [],
		      "title": "My first issue!",
		      "reporter": "dmeyer",
		      "component": null,
		      "watchers": [
		      "summary": "issue from bitbucket",
		      "assignee": "dmeyer",
		      "created_on": "2016-11-03T06:31:17.395256+00:00",
		      "version": null,
		      "edited_on": null,
		      "milestone": null,
		      "updated_on": "2016-11-03T06:31:17.395256+00:00",
		      "id": 1

2. Map Bitbucket fields to Jira fields

Manually rename the following fields in the JSON file to correctly map them to Jira fields.

In Bitbucket export Rename for Jira import
title summary
kind issuetype
content description

3. Create issue types and statuses in Jira

Before import, you need to ensure that the statuses and issue types your Bitbucket issues will map to have already been created in Jira. If they're not created, create them now.

4. JSON import

Once you've completed the above, head over to Importing data from JSON and follow the procedure outlined there.

Last modified on Mar 13, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.