Azure DevOps for Jira
Azure DevOps for Jira
Breadcrumbs

Syncing Jira Work Items to Azure DevOps

Automatically create an Azure DevOps work item whenever a new work item is created in Jira, with fields kept in sync between the two.

Before you begin

Make sure you have an Azure DevOps Sync integration already set up for this direction, with Work Items: Read & Write scope - see Setting Up a Work Item Sync Integration. If you don't have one yet, starting a synchronization below will redirect you there automatically.

If you plan to use Step 4 (User Mapping), that integration's token also needs Identity: Read & Manage.

Step 1. Start a new synchronization

  1. From the Synchronizations tab, select Create new synchronization.

    image-20260829-020938.png

If no integration exists yet for this direction, you'll be redirected to set one up first.

Step 2. Connect Azure DevOps

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

    image-20260829-021033.png


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

    image-20260829-021141.png


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

    image-20260829-021252.png

  4. Select Next.

Step 3. Map fields

  1. Map each Jira work item type to its corresponding Azure DevOps work item type.

    image-20260829-004842.png


  2. Select the Jira field to map to the Azure DevOps field. Select Add fields mapping to map more.

    image-20260829-004940.png


  3. Where a field has a fixed set of values, map those to their corresponding Azure DevOps values too. Select Add value mapping for more.

    image-20260829-005002.png


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

    image-20260829-022013.png


Step 4. Map users (optional)

You can map Azure DevOps users to Jira users. This is an optional feature, but it can be useful for keeping assignees correct across both platforms.

The integration's Personal Access Token needs the Identity (Read & Manage) scope for this to work.

  1. Select Add user mapping.

    image-20260829-022504.png

  2. Map each Jira user to their corresponding Azure DevOps user.

    image-20260829-022534.png

  3. Select Add user mapping again for additional users as needed.

  4. Select Next.

Step 5. Name and save

  1. Give the synchronization a name and select Save.

    image-20260829-022610.png

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

If a required Azure DevOps field isn't populated when the work item is created in Jira, the corresponding Azure DevOps work item won't be created.

Updated: August, 2026