• Products
  • Documentation
  • Resources

Enable code

The code feature gives you greater visibility of your team's work by automatically connecting and displaying your code repositories in your project.

Enable code for your Jira Software project

Only project admins can enable and disable features on a project.

  1. Navigate to your Jira Software project.

  2. Go to Project Settings Features.

  3. Enable the Code feature.

A new menu item, Code, will be added to the project menu.

Connecting your team’s repositories

To use the code feature, you’ll need to integrate Jira Software with a source code management tool like Bitbucket or GitHub. Learn more about integrating Jira with your development tool.

The code feature will display all the repositories your team has connected to the current project.

code page

You can connect a repository to a project by including issue keys at the beginning of your branch names, commit messages, and pull requests. Here’s how:

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

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

  3. When committing changes to your branch, use the issue key at the beginning of your commit message. For example, git commit -m "JRA-123 <summary of commit>". You can also include the issue key at the beginning of 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 complete.

Learn how to reference issues in your development work and read more about integrating Jira Software with your development tools.

Code settings

You can navigate to the code settings from the More options (•••) menu on the top-right corner of the page.

code settings

For example, if you have GitHub installed, select Github settings to manage your app integration.

You can also use this menu to manage your project features if you want to disable the code feature.

View development information in Jira Software

Once you start referencing issues in your development work, you’ll get the following benefits:

Repositories on the Code page

On the Code page, you’ll see a list of all repositories related to the project.

Development panel on Jira issues

Issues referenced in development work will have a Development panel, which you’ll see in the Details section on the issue. The panel shows the status of branches, commits, and pull requests related to the issue.

The Jira issue details view, with a section called Development. The issue has 1 branch, 8 commits, and 1 pull request
  1. Development panel: Hover over branches, commits, and pull requests to see when they were last updated.

Learn more about the development panel

Development info on the board

Once you’ve enabled the Code feature and your team includes issue keys in their branch names, commit messages, and pull requests, you’ll start seeing more development information on your Jira board. Issue cards will display development icons to indicate when they have pull requests, branches, or commits associated with them. You can hover over the icons to view the details of the development activity, and click through to go to your connected development tool. (Note, development icons will not show if your Jira board contains more than 100 issues.)

Development information linked to an issue on a company-managed Jira board

Automations

Use automations to create rules related to development, like transitioning an issue to In progress when a branch is created.

Learn more about how to automate your Jira Cloud processes

 

Additional Help