Azure DevOps for Jira
Azure DevOps for Jira
Breadcrumbs

Syncing Azure DevOps Work Items to Jira

Automatically create a Jira work item whenever a new work item is created in Azure DevOps, 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 and Project and Team: Read & Write scopes - 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-023415.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 Azure DevOps to Jira, then select Continue.

    image-20260829-023615.png


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

    image-20260829-023717.png


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

    image-20260829-023825.png

  4. Select Next.

Step 3. Map fields

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

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

    image-20260829-023908.png


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

    image-20260829-023943.png


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

    image-20260829-024020.png


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

    image-20260829-024036.png

Step 4. Map users (optional)

User mapping isn't required, but it helps assign synced work items to the right person.

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

  1. Select Add user mapping.

    image-20260829-024051.png


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

    image-20260829-024116.png


  3. Repeat for any additional users.

  4. Select Next.

Step 5. Name and save

  1. Give the synchronization a name and select Save.

    image-20260829-024143.png

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

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

Updated: August, 2026