Use Jira Cloud projects in Bitbucket Cloud

Now that you have connected your Jira site to a Bitbucket Cloud workspace, the Jira issues tab is displayed in the left navigation sidebar of each repository. Select the Jira issues tab to display relevant projects and their issues. Relevancy is established when at least one issue 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

1. If you want to associate a Jira project to a Bitbucket repository, mention the issue key in your message or pull request. Once you add your issue key to any commit message or pull request, you will be able to access the issue view by clicking the issue 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

1. In your repository navigation panel, click Jira issues. In the issue list, select the folder icon located at the top right-hand side and click Manage linked projects.

2. In the dialog, select a project from the dropdown, then click Link project.

Unlink a Jira project

1. In your repository navigation panel, click Jira issues. In the issue list, select the folder icon located at the top right-hand side and click Manage linked projects

2. 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 issues. You can check which projects have been linked by clicking Jira issues on the left navigation bar and then clicking the Linked Jira Projects dropdown in the upper-right corner.

Find your Jira issues quickly

You can find your issues by using the search filter or by using the site, project, and status filters located at the top of the Jira issue tab.

Turn the Jira issues tab off

1. 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.

2. Under Atlassian integrations, click Jira.

3. Turn the “Show Jira issues tab on the repositories navigation” toggle off.
   If you turned the toggle off, the Jira issues tab won't be displayed in the left navigation bar anymore when you are in a repository.