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.

Link your team’s repositories

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.

Link repositories using issue keys

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

Link repositories using the toolchain feature

Project admins can link repositories to a software project using the toolchain feature. You can connect multiple code repositories from Bitbucket, GitHub, GitLab, or any other supported tool, and these will display on the code page in your project.

1. Select Project settings from your project menu, then select Toolchain.

2. From the top right, select Add, then select Add code repository.

3. Select your preferred code tool. You may need to install or authenticate the tool.

4. Select your team’s repository from the list.

If the tool is already listed in your toolchain, you can connect work from the tool’s card.

1. Select the add () icon.

2. Select your team’s repository from the list.