Connect Bitbucket Cloud to Jira Software Cloud

Read about how your team 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.

  1. Log in to the Bitbucket Cloud account you want to connect with Jira Software Cloud. You'll need to be an admin on the Bitbucket account.
  2. Choose App marketplace from the avatar (your profile) 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 to Try Jira now  or Learn more about the integration.

  4. Click Connect associated with the Jira Software Cloud instance you want to integrate with Bitbucket Cloud. 
  5. Click Grant access to grant Jira Software access to your Bitbucket Cloud account.
  6. Click Grant access to grant Bitbucket access to Jira.
  7. Choose whether or not you would like to automatically sync and enable Smart Commits for all your repositories.

    These options are selected by default. 

    • automatically sync all existing repos in the Bitbucket account and any repos added in the future. Syncing ensures that repo activity is updated in Jira Software in real time.
    • enable Smart Commits for all existing repos in the account and for any repos added in future. 
      See Processing Jira issues with Smart Commits.

    You can manage these settings later from the 'DVCS accounts' page in Jira Software. See Manage your linked account below.

  8. Click OK.

Once connected, you'll see your Bitbucket repos 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


To disconnect an instance of Jira Software, choose Bitbucket settings from the avatar (your profile) menu > click Jira under Atlassian integrations on the left side menu select the Disconnect button associated with the Jira instance you would like to disconnect.

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.


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 reposTypically, 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 reposTo 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 more options button in the upper-right corner of your repository list.
  3. Select Refresh repositories from the More options dropdown menu.
Disconnect the Bitbucket accountChoose Configure default repository settings from the Actions menu, then Delete.

Last modified on Jun 25, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.