Jira integration

Integrating Bitbucket Server with Atlassian applications

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

When Bitbucket Server is integrated with Jira Software, you and your team get all these benefits:

You can also use Jira Software for delegated management of your Bitbucket Server users. See External user directories .

Your Bitbucket Server administrator needs to set up linking with Jira Software before you'll see these work.

Check development progress of a version in Jira Software

The Release Hub shows the progress of a version, so you can determine which issues are likely to ship at a glance. With Jira Software and Bitbucket Server connected, the commits related to each issue are shown, helping you to spot potential development issues that could cause problems for a release.

When you are ready, you can also release the version from the Release Hub, which marks the version as complete, moves incomplete issues to other versions, and triggers release builds (if Jira Software is connected to Bamboo).

To view the Release Hub (with the project sidebar enabled), navigate to a project, click on Releases, then select a version listed. See Checking the progress of a version for more detailed information about using the Release Hub in Jira Software.

Transition issues automatically

Your workflow can now respond to events in your linked development tools. For example, when a pull request is created, your workflow can be configured to automatically transition the related issue. Configure this from transitions within the Jira workflow editor – see  Advanced workflow configuration in the Jira Software documentation:

The events available in Bitbucket Server are:

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

Bitbucket Server events are published by default. We recommend that you use the latest version of Jira Software to ensure that duplicate events are handled correctly. Jira Software automatically removes duplicate commit events and duplicate branch creation events.

See all related branches, commits and pull requests in an issue

Get visibility into the Bitbucket Server branches, commits and pull requests related to work on an issue, right in the context of the issue in Jira Software. 

Click the links in the Development panel to see details of the work that's been done. You can start creating a pull request from the Commits details dialog, or click through to see a changed file, or the full commit, in Bitbucket Server.

Create Git branches from within Jira Software

You can start creating a branch from an issue. This gives you a faster workflow from picking an issue to starting coding.

Bitbucket Server will suggest the branch type and branch name, based on the issue type and summary – you can change these, of course.

Transition issues from within Bitbucket Server

You can easily transition an issue from within Bitbucket Server. For example, when creating a pull request you may want to transition the issue into review. Click on a linked issue anywhere in Bitbucket Server to see a dialog with the available workflow steps:

Click on a step and complete the fields as required. If there are custom fields that are unsupported by Bitbucket Server, just click Edit this field in Jira to transition the issue directly in Jira Software.

See issues from multiple instances of Jira Software

Bitbucket Server can link to more than one Jira Software server at a time, so different teams can work with their own projects in different instances, or a single team can link to issues across multiple Jira Software servers. Read more about linking Bitbucket Server with Jira Software.

Use issue keys in markdown

When you mention an issue key in Bitbucket Server, for example in a pull request description or a comment, the key gets automatically linked:

Click on the linked key to see details for the issue.

See issue details

Click a linked issue key anywhere in Bitbucket Server to see the details of that issue in a dialog. And you can just click the issue key at the top of the dialog to go straight to the issue in Jira Software:

See issues related to commits and pull requests

Bitbucket Server recognizes issue keys in commit messages, and displays the keys as links on the Commits tabs for both the repository and pull requests:

Click on the linked key to see details for the issue.

Last modified on Feb 2, 2021

Was this helpful?

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