Connect Jira Cloud to Bitbucket Cloud

Connect Jira Cloud applications with your Bitbucket Cloud account for your team to enjoy the seamless integration of issues and code:

Surface repository activity

Jira issues automatically update to show repo branch, commit and pull request activity.

Get deep integration in Bitbucket

See the core details of Jira issues without having to change context, from anywhere in Bitbucket you see a Jira issue key, including commit messages and pull request comments.

Automate Jira workflows

Jira workflows sync with repo activity to update automatically as you work.

Read more about the benefits of integrating Jira applications with Bitbucket Cloud. If you're using a Jira Server application, see Linking a Bitbucket or GitHub repository with JIRA.

Connect Jira Cloud with a Bitbucket Cloud account

Start in Jira Cloud to connect with your Bitbucket account (you can also begin from in Bitbucket Cloud). This works best if you're an admin for the Bitbucket account.

Log in to Jira as a Jira admin (Jira project admin permissions are not sufficient).

Note that the connection process begins a little differently for Jira Software and Jira Core...

Jira Software

If you're using Jira Software, select Projects in the menu bar to choose the Jira project you want to connect to Bitbucket Cloud. Now choose Add item in the project sidebar to link to a repo in your Bitbucket Cloud account. Enter the Bitbucket URL for the repo.

Once the link is created, choose Integrate Bitbucket to sync your Jira and Bitbucket accounts.

Jira Core

If you're using Jira Core:

Go to Applications > DVCS accounts in the admin area, and click Link Bitbucket Cloud account.

Continue the connection process...

The connection process takes you to Bitbucket. Make sure you're logged in to the Bitbucket account that has the repos you want to connect with Jira, and then Grant access for Jira to your Bitbucket account:.

Now, back in Bitbucket, grant Bitbucket access to Jira.

You can choose how Jira should handle syncing and Smart Commits for the repos in the Bitbucket account.

Choose whether Jira Cloud should:

  • 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 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. See Manage your linked account below.

Once connected, you'll see your Bitbucket repos listed on the 'DVCS accounts' page in Jira.

Approve an uncompleted connection request

When someone begins connecting Jira with Bitbucket Cloud, but are unable to complete the process because they're not logged in as a Jira admin (although they may be logged in as a Jira project admin, for example).

Their options are to:

  • Log out and log back in using a Jira admin account, if they have such an account.
  • Ask a Jira admin to complete the connection.

In either case, a Jira admin can complete the connection by going to Applications > DVCS accounts

Manage your linked account settings

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

If necessary, you can force Jira to update its Bitbucket Cloud repo activity data:

  • A soft sync retrieves changes made since the last sync – click the sync icon beside the Last activity date for the repo.
  • A full sync clears all existing data in Jira and resyncs everything – hold SHIFT and click the sync icon beside the Last activity date for the repo.

See Synchronize an account.

Control auto access to repos by Jira users

 Read about configuring automatic team invitations.

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

Last modified on May 31, 2018

Was this helpful?

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