Connect Bitbucket Cloud to Jira Software Cloud

Read about how you and your colleagues can enjoy the seamless integration of issues and code when you connect Bitbucket Cloud with Jira Software Cloud.

This integration has no effect on the Bitbucket Cloud issue tracker and will only import, track, and recognize issues from Jira. 

Connect your Bitbucket workspace to Jira Software Cloud

Start in Bitbucket to connect with Jira Software Cloud (you can also start in Jira Cloud applications). This works best if you have Jira admin permissions for the Jira Software Cloud instance with which you want to connect. If you want to connect Bitbucket Cloud with a Jira Data Center application, see Connect Bitbucket Cloud to Jira Software Data Center.

Before you begin:

  • To log into the workspace you want to connect with Jira Software Cloud, you'll need to be an admin on the workspace.

If you don't have any Jira Software Cloud instances connected to your Atlassian account, you can choose Try Jira now or Learn more about the integration.

Steps

  1. Click your profile avatar > select a workspace from the Recent workspaces list or select All workspaces to display an entire list from which you can select.

  2. Once you’re in your workspace, select the Settings cog on the top navigation bar.

  3. Select Workspace settings from the Settings dropdown menu.

  4. Click Jira under Atlassian Integrations

  5. Choose the Jira Cloud instance you want to integrate with your Bitbucket Cloud workspace and click Connect

  6. Click Grant access to grant Jira Software access to your Bitbucket Cloud workspace.

  7. Click Grant access to grant Bitbucket access to Jira.

  8. Choose whether or not you would like to automatically sync and enable Smart Commits for all your repositories. Note: These options are selected by default. See Processing Jira issues with Smart Commits for more information. You can manage these settings later from the 'DVCS accounts' page in Jira Software. 

  9. Click OK.

Once connected, you'll see your Bitbucket repositories listed on the 'DVCS accounts' page in Jira Software. The DVCS accounts page is only visible if you are a Jira Admin. Head into Jira settings > Products then under the Integrations heading you should see DVCS accounts.

Highlighting ‘stale' pull requests

For repositories that are connected to a Jira project, any pull requests that have been open longer than a typical pull request and haven’t had any activity for awhile will be marked as ‘Stale’ which will be displayed in a lozenge below the PR description, and the Created date will be highlighted in red. Note: This is on by default and is not configurable, and the pull request must have been connected to a Jira project for 8 weeks for the ‘Stale’ callouts to be implemented and displayed. See the info box below for more details on how stale PRs are calculated.

How ‘stale’ pull requests are calculated
The calculation to determine whether or not a pull request is ‘stale’ is based on a rolling 8-week analysis of pull requests in the same repository. The cycle time is calculated based on the last 8 weeks of PR merged data and calculating the 85th percentile of the value, while also taking the time since the last activity was taken on the pull request into consideration.

Control visibility of your Bitbucket repositories in Jira Software

You or your team may have repositories in a workspace that is connected to Jira Software, but you don’t want one or more of the current repositories to be connected to the Jira site. You can control the visibility of these repositories by moving them to a different workspace.

  1. Make sure the workspace you want to move the repository to already exists, or you need to create a new workspace.

  2. Move the repository to the new or existing workspace that is not connected to the Jira site. Refer to Transfer repositories and groups to a workspace for more information.

  3. On the DVCS accounts page, select Refresh repositories from the … (more options) menu of the connected workspace to refresh repository connections.

Manage your linked workspace settings

From Bitbucket Cloud

Steps to remove the connection to Jira Software

  1. To remove the connection to Jira Software, go to your profile avatar > select a workspace from the Recent workspaces list or select All workspaces to display an entire list from which you can select.

  2. Once you’re in your workspace, select the Settings cog on the top navigation bar.

  3. Select Workspace settings from the Settings dropdown menu.

  4. Click Jira under Atlassian Integrations. 

  5. Find the Jira Cloud instance you want to disconnect and click Disconnect.

From Jira Software

After you link a Bitbucket Cloud workspace with Jira Software, you can manage the connection and the linked repos from the 'DVCS accounts' page in Jira.

If you're having problems with the connection, see Troubleshoot connections with Bitbucket Cloud.

Action

Instruction

Control Smart Commits

For the workspace: select Configure default repository settings from the (more options) menu.

Modify the Smart Commits default setting as required. The changed setting only applies to new repositories added to the Bitbucket workspace.

For a repository: select, or clear, the Smart Commits checkbox in the row for the repository, as required.

Read more about processing Jira issues using Smart Commits.

Refresh the list of repos

To manually update the list of connected repositories, select Refresh repositories from the (More options) menu.

Disconnect the Bitbucket workspace

Select Configure default repository settings from the (More options) menu, then Disconnect.

 

Additional Help