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.

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.

Choose App marketplace from the avatar (your profile) menu:

Now find 'Jira' and click Add:

Enter the URL for the Jira Software Cloud instance you want to connect with, such as :

You'll see an error dialog if the URL isn't for a Jira Software Cloud instance:

Click Add to start the connection process. You need to grant Jira Software access to your Bitbucket Cloud account:

We'll take you to Jira Software, where you can grant Bitbucket access to Jira:

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

Choose whether Jira Software 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 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.

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

From in Bitbucket

You can remove the connection to Jira Software by choosing Bitbucket settings from the avatar (your profile) menu, then clicking Installed apps under Apps and features on the left side menu:

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

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.

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

Last modified on Jan 10, 2019

Was this helpful?

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