Jira integration

Integrate with Atlassian applications

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Integrating Bitbucket Data Center and Server with Jira Software makes it easy to keep everyone up to date on code changes and helps to minimize switching between tools. Once they're integrated, you can link a Bitbucket commit, branch, or pull request to a Jira issue by including the issue key.

In Jira you can then:

And in Bitbucket you can:

You can also use Jira Software for delegated management of your Bitbucket users. To learn more, see External user directories.

See real-time development status updates within Jira issues

Jira integration development panel

Get visibility into development status from within the context of an issue. The development panel shows a summary of related branches, commits, pull requests, and builds. You can also select the links within this panel to see more information.

When it's time to pick up a new task, you can then create a branch directly from an issue. Using the issue type and summary, Jira will suggest the branch type and branch name, helping you get to work faster. 

Trigger Jira issue transitions using Bitbucket events

With just a few clicks, you can configure your Jira workflow to respond to events in Bitbucket. For example, when a pull request is created, Jira can automatically transition the status of a linked issue. The events available in Bitbucket are:

  • Branch created
  • Commit created
  • Pull request created
  • Pull request merged
  • Pull request declined

Learn more about advanced workflow configuration in the Jira Software documentation. 

Check development progress for a version in Jira

progress of a version

From the Jira release hub, you can see the progress of a version and determine which issues are going to ship at a glance. You can also see the commits related to each issue, helping you spot potential development issues that could cause problems. 

Learn more about checking the progress of a version in the Jira Software documentation.

See development information in Jira Software Cloud using OAuth

Integrating with Jira Software Cloud enables Bitbucket Data Center to send its development information using OAuth credentials. Integration not only sends development information such as branches, commits, and pull requests, but also give access to new automation and reporting features in Jira Software Cloud such as:

  • calculating Cycle time metrics - the time that you take work to get from the first commit on a branch to production.

  • linked Bitbucket repositories are displayed in the Jira Software Cloud's code tab for quick and easy access.

  • triggering Automation for Jira events - these include Branch created, Commit created, Pull request created, Pull request declined, and Pull request merged. If you haven't linked your Jira and Bitbucket accounts, you'll be prompted to do so the first time you use these triggers.

jira code tab

Learn more about integrating with Jira Software Cloud using OAuth.

See assigned Jira issues on the Bitbucket dashboard

assigned Jira issues on the dashboard

On the Bitbucket Your work dashboard, you can see open Jira issues assigned to you. This makes it easy to see what's coming up at a glance without jumping between tools. When it's time to start a new task, you can then select the issue key to open the issue summary modal, or you can create a branch from the Actions menu and get started.

Interact with Jira issues in Bitbucket

interact with Jira issues


When you mention a Jira issue key in a Bitbucket commit, branch, or pull request, the two are automatically linked. In Bitbucket you can then select the issue key to see more information or interact with the issue. Selecting the issue key in the modal will also take you straight to the issue in Jira.

To learn how to integrate them now, see Link Bitbucket with Jira

Validation of Jira issues in commit messages

In Bitbucket Data Center, create a requirement to validate whether Jira issues exist in commit messages. When a user pushes a commit without a valid Jira issue key, they will be alerted as to why they cannot commit the file.

To learn more about setting up these requirements, see Commit checker for Jira issues.

Last modified on Aug 31, 2021

Was this helpful?

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