Skip to main content
Skip table of contents

How to Sync Azure DevOps and Jira Work Items

Azure DevOps for Jira supports Work Item Synchronization in both directions:

  • Azure DevOps → Jira

  • Jira → Azure DevOps

This guide explains how to configure the integration and set up synchronization between the two platforms.

Integration Set up

Before creating synchronizations, an integration must first be configured.

  1. From the Jira admin settings, navigate to Marketplace apps.

  2. Select Azure DevOps Sync.

  3. Open the Integrations tab and click Create new integration.

    image-20260117-034326.png

  4. Select the direction of synchronization:

    • Jira to Azure DevOps

    • Azure DevOps to Jira

    image-20260117-034532.png

  5. Enter the Azure DevOps organization name for the project to be synchronized.

    image-20260117-034954.png

  6. Enter the Azure DevOps Personal Access Token (PAT).

    image-20260117-035036.png

    Note: Required Access Scopes:

    • Jira to Azure DevOps:

      • Work Items: Read & Write

    • Azure DevOps to Jira:

      • Work Items: Read

      • Project and Team: Read & Write

  7. Select the Jira spaces this integration can access.

    image-20260117-035411.png

  8. Provide a descriptive name to easily identify the integration.

    image-20260117-035715.png

  9. Click Test Connection to validate the configuration.

    image-20260117-035825.png

  10. Click Save to complete the integration setup.

    image-20260117-040536.png

Azure DevOps to Jira Synchronization

Once an Integration is configured, a synchronization can be created.

If no relevant integration exists, you will be redirected to the integration setup screen.

From the Synchronizations tab, select Create new synchronization.

image-20260119-002708.png

Connect Azure DevOps

  1. Select Azure DevOps to Jira, then click Continue.

    image-20260119-003043.png

  2. Select an existing Azure DevOps integration or create a new one.

    image-20260119-003226.png

  3. From the drop down selection, select the Jira space and Azure DevOps project to be synchronized.

    image-20260119-003647.png

  4. Click Next.

Field Mapping

Use field mapping to align Azure DevOps work items with Jira work items.

  1. Map the Azure DevOps work item type to the corresponding Jira work item type.

    image-20260119-011905.png

  2. Select the Azure DevOps field to map to the Jira field. Click Add fields mapping to synchronize additional fields.

    image-20260119-031655.png

  3. When a field has associated values, these can be mapped to the corresponding fields values in Jira. Click Add value mapping to map additional values.

    image-20260119-031801.png

  4. Once all required fields are mapped, click Next.

    image-20260119-032624.png

User Mapping

User mapping is optional but helpful for assigning work items correctly.

For User Mapping to work correctly, the Personal Access Token (PAT) must include the Identity (Read & Manage) scope of access

  1. Click Add user mapping.

    image-20260119-033720.png

  2. Select the Jira user and the corresponding Azure DevOps user.

    image-20260119-034050.png

  3. Repeat as needed for additional users.

  4. Click Next.

Final Step

Provide a name for the synchronization and click Save.

image-20260119-034240.png

Work items created in Azure DevOps will now automatically create corresponding work items in the selected Jira space.

Jira to Azure DevOps Synchronization

The setup process is similar for synchronizing from Jira to Azure DevOps.

If no relevant integration exists, you will be redirected to the integration setup screen.

From the Synchronizations tab, select Create new synchronization.

image-20260119-002708.png

Connect Azure DevOps

  1. Select Jira to Azure DevOps, then click Continue

    image-20260119-183515.png

  2. Select an existing Azure DevOps integration or create a new one.

    image-20260119-183626.png

  3. Select the Jira space and Azure DevOps project to synchronize.

    image-20260119-183735.png

  4. Click Next.

Field Mapping

  1. Map the Jira work item type to the corresponding Azure DevOps work item type.

    image-20260119-184050.png

  2. Select the Jira field to map to the Azure DevOps field. Click Add fields mapping to synchronize additional fields.

    image-20260119-184217.png

  3. When a field has associated values, these can be mapped to the corresponding fields values in Azure DevOps. Click Add value mapping to map additional values.

    image-20260119-184351.png

  4. Once all desired fields and values are mapped, click Next.

    image-20260119-184504.png

User Mapping

It’s possible to Map Azure DevOps users to Jira users. This is an optional future, however it can be useful for synchronizing between the platforms.

For User Mapping to work correctly, the Personal Access Token (PAT) must include the Identity (Read & Manage) scope of access

  1. Click Add user mapping.

    image-20260119-033720.png

  2. Map Jira users to their corresponding Azure DevOps users.

    image-20260119-034050.png

  3. Select Add user mapping to map additional users as needed.

  4. Click Next.

Final Step

Provide a name for the synchronization and click Save.

image-20260119-184725.png

Work items created in Jira will now automatically create corresponding work items in the associated Azure DevOps project.

Updated:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close