Use Jira Cloud projects in Bitbucket Cloud
Now that you have connected your Jira site to a Bitbucket Cloud workspace, the Jira work itemss tab is displayed in the left navigation sidebar of each repository. Select the Jira work items tab to display relevant projects and their work items. Relevancy is established when at least one work item key from the Jira project is referenced in a commit message or pull request. You can also link projects to repositories manually.
Link project 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 project 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 project 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 click Manage linked projects.
In the dialog, choose a project from the dropdown, then select Link project.
Unlink a Jira project
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 click Manage linked projects
Go to the project you want to unlink and click the unlink project icon.
Navigate to your Jira projects
Once you've connected a Jira site to a Bitbucket Cloud workspace, repositories will show relevant projects and work items. You can check which projects have been linked by clicking Jira work items on the left navigation bar and then clicking the Linked Jira Projects 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, project, 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?