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 server application, see Connect Bitbucket Cloud to Jira Software Server.

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.

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

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. Click Settings on the left sidebar menu.

3. Click Jira under Atlassian Integrations. 

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