Use Jira Cloud spaces in Bitbucket Cloud
Now that you have connected your Jira site to a Bitbucket Cloud workspace, the Jira work items tab is displayed in the left navigation sidebar of each repository. Select the Jira work items tab to display relevant spaces and their work items. Relevancy is established when at least one work item key from the Jira space is referenced in a commit message or pull request. You can also link spaces to repositories manually.
Link a Jira space to a repository automatically
Prerequisites
Connect your Bitbucket and Jira instances.
To configure this feature you need to be an administrator of the sites you want to connect to.
To configure this feature you need to be the administrator of the Bitbucket account you want to integrate with Jira Cloud.
Steps
If you want to associate a Jira space to a Bitbucket repository, mention the work item key in your message or pull request. Once you add your work item key to any commit message or pull request, you will be able to access the work item view by selecting the work item key link.
Link a space to a repository manually
Prerequisites
Connect your Bitbucket and Jira instances.
To configure this feature you need to be an administrator of the sites you want to connect to.
To configure this feature you need to be the administrator of the Bitbucket account you want to integrate with Jira Cloud.
Steps
In your repository navigation panel, select Jira work items. In the work item list, select the folder icon located at the top right-hand side and select Manage linked spaces.
In the dialog, choose a space from the dropdown, then select Link space.
Unlink a Jira space
In your repository navigation panel, select Jira work items. In the work item list, select the folder icon located at the top right-hand side and select Manage linked spaces.
Go to the space you want to unlink and select the unlink space icon.
Navigate to your Jira spaces
Once you've connected a Jira site to a Bitbucket Cloud workspace, repositories will show relevant spaces and work items. You can check which spaces have been linked by selecting Jira work items on the left navigation bar, then the Linked Jira Spaces dropdown in the upper-right corner.
Find your Jira work items quickly
You can find your work items by using the search filter or by using the site, space, and status filters located at the top of the Jira work item tab.
Turn the Jira work items tab off
In Bitbucket, navigate to the settings for your workspace. From the workspace, select the Settings cog on the top navigation bar and select Workspace settings from the Settings dropdown menu.
Under Atlassian integrations, select Jira.
Turn the “Show Jira work items tab on the repositories navigation” toggle off.
If you turned the toggle off, the Jira work items tab won't be displayed in the left navigation bar anymore when you are in a repository.
This does not disconnect the Jira site and Bitbucket workspace so work item links and other Jira integration feature will continue to work as expected.
Was this helpful?