Connect Bitbucket Cloud to Jira Cloud

Read about how you and your colleagues can enjoy the seamless integration of issues and code when you connect Bitbucket Cloud with Jira 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 Cloud

Start in Bitbucket to connect with Jira Cloud (you can also start in Jira Cloud applications). This works best if you have Jira admin permissions for the Jira 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 Data Center.

Before you begin:

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

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 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. 

9. Click OK.

Once connected, you'll see your Bitbucket repositories listed on the 'DVCS accounts' page in Jira. 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.

Control visibility of your Bitbucket repositories in Jira

You or your team may have repositories in a workspace that is connected to Jira, 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

1. To remove the connection to Jira, 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

After you link a Bitbucket Cloud workspace with Jira, 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.