Get started for Jira administrators

This guide explains how Jira administrators can configure Azure DevOps for Jira and connect Jira Cloud to Microsoft Azure DevOps.

Content:

Before you begin

Before configuring the integration, make sure that:

• You are a Jira administrator.

• You have access to the Azure DevOps organisation or organisations you want to connect.

• You can create a Personal Access Token (PAT) with the required permissions.

If your organisation restricts application or API access, contact your Azure DevOps administrator before continuing.

For more information about Azure DevOps application access policies, see the Microsoft documentation.

Step 1. Create a Personal Access Token in Azure DevOps

Azure DevOps for Jira uses a Personal Access Token (PAT) to connect to your Azure DevOps organisation.

Before setting up the integration, create a PAT in Azure DevOps with access to the organisation you want to connect.

For instructions, see How to create a Personal Access Token in Microsoft Azure DevOps.

Keep the following in mind:

• Make sure the PAT has the permissions required to access the Azure DevOps data you want to display in Jira.

• Create the PAT for the specific Azure DevOps organisation you want to connect.

• Note the PAT's expiration date so that you can renew it before it expires.

• You will need to enter the PAT and the associated Azure DevOps organisation name when configuring the integration.

Step 2. Create an Azure DevOps integration

Once you have created your Personal Access Token (PAT), you can connect Azure DevOps to Jira.

1. Go to the Marketplace apps section of your Jira administration by clicking the Settings cogwheel in the top-right corner and selecting Marketplace apps.

   

   
   

2. Expand Azure DevOps and select Dev Activities in Jira.

   

   
   

3. Select Integrate with Azure DevOps.

   

   
   

4. Select your Azure DevOps hosting type: Cloud or On-Premises.

   

   
   

5. Enter your Personal Access Token and Azure DevOps Organization name.
   

   

6. To automatically connect all associated Azure DevOps projects after saving the integration, select Connect all Azure DevOps projects automatically.

   

   If you prefer to connect individual projects manually after creating the integration, leave this option unselected.
   

7. To receive a notification on the Global Configuration page when your PAT is approaching its expiration date, select Token upcoming expiration notification and enter the PAT's expiration date.

   

   
   

8. Show Deployments in Jira Development Panel is selected by default. If you do not want deployments to appear in the Jira Development panel, clear this option.

   

   
   

9. Enter a suitable Integration name, then select Save.

   

Step 3. Connect Azure DevOps projects

After saving the integration, the Project connections tab opens.

You can connect Azure DevOps projects automatically or manually.

Connect projects automatically

If you selected Connect all Azure DevOps projects automatically during the integration setup, your Azure DevOps projects will begin connecting automatically after you save the integration.

Once the process is complete, the status banner updates, and the connected projects are displayed below it.

Connect projects manually

To connect individual Azure DevOps projects:

1. From the Project connections tab, select Create project connection.

   

   
   

2. Select the Azure DevOps project you want to connect, then select Save.

   

   
   

3. To connect another project, select Create project connection and repeat the process.

   

   
   

Repeat this process for each additional Azure DevOps project you want to connect.

Security

For more information about how Azure DevOps for Jira handles security and data, see Frequently asked security questions.

Related guides

• Get started for Jira end-users

• Azure DevOps On-Premises (Server) for Jira Cloud Guides

• Creating Branches

Updated: August, 2026