Link repositories to a software project

Keep track of your team’s work by linking code repositories from connected development tools to your software project.

Before you begin

Before you can link repositories to your software project, you must complete the following steps:

  1. Enable the code feature in your project. How to enable Code

  2. Connect Jira to Bitbucket, GitHub or another supported source code management tool. Read more about integrating Jira with your development tools

  3. Make sure your tool is configured properly so it can send development information to Jira.

The Code feature displays a list of the repositories that are linked with your project, helping you keep track of where your team is working. It can display up to 100 linked code repositories.

Code page showing connected repositories

You can link a repository to a project by including issue keys in your branch names, commit messages, and pull requests. Here’s how:

  1. Find the key for the Jira issue you want to link to, for example “JRA-123”.

  2. Checkout a new branch in your repository, using the issue key in the branch name. For example, git checkout -b JRA-123-<branch-name>.

  3. When committing changes to your branch, use the issue key in your commit message. For example, git commit -m "JRA-123 <summary of commit>". You can also include the issue key in the pull request title.

After you commit your changes or push your branch, go to Code in the project menu to see the connected repository. It can take a few minutes for the connection to finish.

How to reference issues in your development work

Still need help?

The Atlassian Community is here for you.