robotsnoindex

Connect Jira sites to your Bitbucket workspaces. This integration allows you to curate your repositories to show relevant Jira projects, update Jira issues within your repo, and linking code to Jira by creating branches from issues and 

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 configure this feature you need to be the administrator of the Bitbucket account you want to integrate with. 

How do you link a project or issue to a repository

The new Jira issues tab allows you to see and interact with your Jira projects from within Bitbucket. 

In the following instructions, you'll learn how to link projects and issues from Bitbucket.

  1. In Bitbucket, choose a repository and go to Jira issues. 
    The first time you access this feature, you will be prompted to go to your team settings.
  2. Under Atlassian integrations, click Jira.
  3. Choose a site and click Connect
  4. You'll be prompted with a permission window. Click Grant access.
    Once you grant access, you get redirected to your Jira Software site. 
  5. Grant access to Jira Software.
    You'll see a window confirming the connection.
  6. In your repository navigation panel click Commits. 
    In the commit list, you'll able to see the issue keys belonging to the projects that live in the connected site.
  7. 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.

Navigate to your Jira projects

Once you've connected a site to a workspace, repositories will show relevant projects and issues. However, if you've linked multiple Jira projects, you can switch between them by using the project navigator located at the top navbar. You can check which projects have been linked by clicking  

Find your Jira issues quickly

You can find your issues by using the search filter or using the project, status, and site filters. 

How to turn the Jira issues tab off

  1. In Bitbucket, choose a repository and go to Jira issues. 

    The first time you access this feature, you will be prompted to go to your team settings.

  2. Under Atlassian integrations, click Jira.
  3. Turn the tab toggle on or off.
    If you turned the toggle off, the Jira issues tab won't show up in your menu anymore.