Get started with Bitbucket Cloud
New to Bitbucket Cloud? Check out our get started guides for new users.
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.
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.
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.
Steps
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.
Once you’re in your workspace, select the Settings cog on the top navigation bar.
Select Workspace setting from the Settings dropdown menu.
Click Jira under Atlassian Integrations.
Choose the Jira Cloud instance you want to integrate with your Bitbucket Cloud workspace and click Connect.
Click Grant access to grant Jira Software access to your Bitbucket Cloud workspace.
Click Grant access to grant Bitbucket access to Jira.
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.
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 > Products then under the Integrations heading you should see DVCS accounts.
You or your team may have repositories in a workspace that is connected to Jira Software, but you don’t want one or more of the current repositories to be connected to the Jira site. You can control the visibility of these repositories by moving them to a different workspace.
Make sure the workspace you want to move the repository to already exists, or you need to create a new workspace.
Move the repository to the new or existing workspace that is not connected to the Jira site. Refer to Transfer repositories and groups to a workspace for more information.
On the DVCS accounts page, select Refresh repositories from the … (more options) menu of the connected workspace to refresh repository connections.
Steps to remove the connection to Jira Software
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.
Click Settings on the left sidebar menu.
Click Jira under Atlassian Integrations.
Find the Jira Cloud instance you want to disconnect and click Disconnect.
After you link a Bitbucket Cloud workspace 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 |
---|---|
Control Smart Commits | For the workspace: select Configure default repository settings from the (more options) menu. Modify the Smart Commits default setting as required. The changed setting only applies to new repositories added to the Bitbucket workspace. For a repository: select, or clear, the Smart Commits checkbox in the row for the repository, as required. Read more about processing Jira issues using Smart Commits. |
Refresh the list of repos | To manually update the list of connected repositories, select Refresh repositories from the (More options) menu. |
Disconnect the Bitbucket workspace | Select Configure default repository settings from the (More options) menu, then Disconnect. |
Was this helpful?