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 account 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, click Settings on the left sidebar menu.

  3. Click Jira under Atlassian Integrations

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.

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

  2. Click Grant access to grant Jira Software access to your Bitbucket Cloud account.

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

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

  5. 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 > Applications then under the Integrations heading you should see DVCS accounts.

Manage your linked account settings

From Bitbucket Cloud

Steps

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

Remove a repo

Hover over the row for the repo in the 'DVCS accounts' page, and click the 'X' on the right.

Add a repo

Start typing the repo name in the Add repository field until you see the one you want, then click Add.

Control Smart Commits

For the account: choose Configure default repository settings from the Actions menu.

Now modify the Smart Commits default setting as required:

 

The changed setting only applies to new repos added to the Bitbucket account.

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

Read more about processing Jira issues using Smart Commits.

Control auto-syncing for repos

Typically, new repos added to the Bitbucket account are automatically synced, to show new branch, commit and pull request activity in Jira. You can turn off auto-syncing for new repos by choosing Configure default repository settings from the Actions menu, and changing the Automatically sync checkbox.

Refresh the list of repos

To manually update the list of connected repositories, choose Refresh repositories from the Actions menu.

Manually sync repo activity with Jira

  1. To manually refresh your repositories in Jira, choose Jira Settings from the left navigation menu > Products from the Jira Settings menu > DVCS accounts under the Integrations heading.

  2. Click 

     in the upper-right corner of your repository list.

  3. Select Refresh repositories from the More options dropdown menu.

Disconnect the Bitbucket account

Choose Configure default repository settings from the Actions menu, then Delete.

 

Last modified on Aug 12, 2020
Cached at 6:05 AM on Oct 30, 2020 |

Additional Help

Ask the Community