Connect Bitbucket Cloud to JIRA Cloud applications

Read about how your team can enjoy the seamless integration of issues and code when you connect Bitbucket Cloud with JIRA Software Cloud.

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 you want to connect with. If you want to connect Bitbucket Cloud with a JIRA server application, see Connect Bitbucket Cloud to JIRA Server applications.

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 Integrations from the avatar menu:

Now find the 'JIRA' add-on and click Add:


Enter the URL for the JIRA Software Cloud instance you want to connect with, such as https://teamsinspace.atlassian.net :


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:


Now, back in Bitbucket, grant Bitbucket access to JIRA Software:

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.

Manage your linked account settings

From in Bitbucket

You can remove the connection to JIRA Software by choosing Bitbucket settings from the avatar menu, then clicking Manage integrations, under 'Integrations and features' on the left:

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.

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.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport