Enjoy the seamless integration of issues and code when you have Jira Software connected to Bitbucket Cloud, and your other development tools.
In Bitbucket Cloud, you can see and interact with issues similar to the way you would in Jira Software. Edit, comment, add attachments, transition, watch, and much more.
If you have Prevent cross-site tracking enabled in Safari, you won't be able to open Jira issues in the same tab or window. To view the issue, open it in a different tab or window.
Before you begin
Make sure you have:
How to reference Jira issues in developer tools
Developers just have to reference Jira issue keys in commits, branches, pull requests, etc, as described in the table below.
In all cases, the issue key must use to the default Jira key format – that is, two or more uppercase letters (
[A-Z][A-Z]+), followed by a hyphen and the issue number. For example, ABC-123.
Include the issue key in the commit message.
For example, a commit message like this "TIS-1 Initial commit" will automatically transition the TIS-1 issue from 'To Do' to 'In Progress'.
Include the issue key in the branch name when you create the branch.
If you create the branch from the Development panel in a Jira issue, the issue key is added automatically.
For example, if you name your branch "TIS-2_feature", the TIS-2 issue in Jira will automatically transition from 'To Do' to 'In Progress'. (Note that Git doesn't allow spaces in branch names.)
Do at least one of the following:
If you create the pull request from the Branches dialog of the Development panel in a Jira issue, the issue key is added automatically.
For example, if you create a pull request that has "TIS-3" in the title, the TIS-3 issue will automatically transition from 'In Progress' to 'In Review'. If you reopen, decline, or merge the pull request, it will also transition the TIS-3 issue accordingly.
Include the issue key in the review title when you create the review.
For example, if you name your review "TIS-4 New story" and start the review, the TIS-4 issue will automatically transition from 'In Progress' to 'In Review'. If you reject, abandon, or close the review, it will also transition the TIS-4 issue accordingly.
For Bamboo, a build is automatically linked to an issue if one of the build's commits includes the issue key in its commit message. The issue key must be included in the commit to activate this feature.
For Pipelines, simply include the issue key in the branch name.
A deployment to an environment, such as production or testing, is linked if a commit associated with the deploy contains the issue key in its commit message. The issue key must be included in the commit to activate this feature.