Get started for Jira end-users

This guide explains how to use Azure DevOps for Jira to link development activity from Microsoft Azure DevOps to Jira work items.

Once your Jira administrator has configured the integration, you can view related Azure DevOps development activity directly in Jira, including branches, commits, pull requests, builds, and deployments.

Before you begin

Before you start, your Jira administrator must:

• Install and configure Azure DevOps for Jira.

• Connect the Azure DevOps projects you need to use with Jira.

You must also have the View development tools permission in Jira to view development activity.

Link Azure DevOps development activity to a Jira work item

To link Azure DevOps development activity to a Jira work item, include the Jira work item key in your development activity.

For example, if your Jira work item key is ADOJ-1, use ADOJ-1 when creating a branch, commit, or pull request.

Branches

Include the Jira work item key in the branch name.

For example:

ADOJ-1-branch-name

or:

feature/ADOJ-1_demo-feature-branch

Azure DevOps for Jira also supports Git Flow branch names.

Commits

Include the Jira work item key in your commit message.

For example:

ADOJ-1 Add Azure DevOps integration

or:

Fixes ADOJ-1

You can also use Jira Smart Commits in your commit messages to perform supported actions on Jira work items, such as adding comments, recording time, or transitioning work items.

For more information, see the Smart Commits documentation.

Pull requests

Include the Jira work item key in the pull request title or description.

For example:

ADOJ-1 Add Azure DevOps integration

Once the pull request is created, it can be linked to the corresponding Jira work item.

Builds

A build is linked to a Jira work item when one of the commits included in the build contains the work item key in its commit message.

For example, if a build contains a commit referencing ADOJ-1, the build can be associated with the ADOJ-1 work item in Jira.

Deployments

A deployment is linked to a Jira work item when a commit or pull request associated with the deployment contains the Jira work item key.

For example, if a deployment contains a commit referencing ADOJ-1, the deployment can be associated with the ADOJ-1 work item in Jira.

If you are using Azure DevOps YAML pipelines, see How to integrate Azure DevOps YAML pipelines deployments with Jira.

View Azure DevOps activity in Jira

Once Azure DevOps development activity has been linked to a Jira work item, you can view it directly from the work item's details page.

Azure DevOps development activity is displayed in the Development and Releases panels.

Development panel

The Development panel displays development activity associated with the work item, including:

• Branches

• Commits

• Pull requests

• Builds

Select an activity type to view more detailed information and access the corresponding Azure DevOps resources.

Releases panel

Deployments are displayed in the Releases section of the Development panel.

The panel shows the status of the latest deployment. Select the deployment information to view additional details.

Troubleshooting

My development activity isn't appearing

If your Azure DevOps development activity isn't appearing in Jira, check the following:

• Make sure the Jira work item key is included in the branch name, commit message, or pull request.

• Make sure the work item key is formatted correctly using capital letters. For example, use ADOJ-1, not adoj-1.

• Make sure the Azure DevOps project is connected to Jira.

• Make sure your changes have been pushed to the connected Azure DevOps repository.

• Confirm that you have the View development tools permission in Jira.

• Allow a few minutes for new development activity to synchronise with Jira.

If the activity still does not appear, contact your Jira administrator.

Related guides

• How to find the Jira issue key?

• Get started for Jira administrators

• Creating Branches

Updated: August, 2026