Azure DevOps for Jira
Auto Light Dark
Auto Light Dark

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.

Step 4 (User Mapping) works from your Azure DevOps project team membership by default, with no extra token scope needed. To map users from anywhere in the organization instead of just the project's team, add the optional Member Entitlement Management: Read scope.


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-20260916-015506.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-20260916-015624.png


  4. Optionally, turn on Synchronize comments and/or Synchronize attachments to keep those in sync as well (attachments up to 25 MB per file, over a direct Azure DevOps Cloud connection).

    image-20260916-015711.png
  5. 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.

This reads from your Azure DevOps project's team membership by default. Add the optional Member Entitlement Management: Read scope to map users from across the whole organization instead of just the project's team.

  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: September, 2026