---
sourceDocument: Australia Strategic Portfolio Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-business-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Strategic Portfolio Management

ft:clusterId :

    - itbm

bundleId :

    - itbm

workflow :

    - Technology


---

# Import work items from Azure DevOps to Agile Development 2.0

# Import work items from Azure DevOps to Agile Development 2.0 {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Import work items and iterations of an Azure DevOps project into Agile Development to track and update the status of your work.

## Before you begin

* Set up team integration settings for your Azure DevOps projects. For more information, see [Associate Azure DevOps projects with assignment groups in Agile Development 2.0](https://www.servicenow.com/docs/trDcuvXPeccUDGW8JLERsw#team-integration-settings-agile-azure "Associate your Azure DevOps projects and teams with assignment groups in Agile Development 2.0 to enable import and export of issues between the two applications.").
* Role required: sn_ado_int.user
{#bulk-import-agile-azure__ul_vxc_l31_4kb}

## Procedure

1. Navigate to AllAgile Azure DevOps IntegrationAzure DevOps Instances.
2. Open your Azure DevOps instance record.
3. From the Azure DevOps Projects related list, open a project record.
4. Enable import and export of work items by selecting the Enable Workitems Import and Enable Workitems Export options.
5. Enable synchronization of sprint data by selecting the Sync Sprints option.
6. Click Import Work Items.
7. Select a date and time range.
8. Click Submit.  
   Note:  
   The bulk import action doesn't import the Description and Acceptance criteria fields. However, if there's an update on these records in Azure DevOps after the import is done, these fields are synced in Agile through webhook events.

   Details of your import requests are available in the Azure DevOps Import
   Requests related list.

   You can view all the imported work items and sprints in the Agile Development application.  
   * The relationship between the stories and epics stays as it is in Azure DevOps.The Assigned to field of the story is set to the user based on the user's email address, which must be unique
     per user account.

   * The mapping of states of an iteration in Azure DevOps to sprints in Agile Development is as follows:{#bulk-import-agile-azure__table_nm2_ddj_flb__entry__2}

     | State in Azure DevOps | State in Agile Development 2.0 |
     |-|-|
     | Past | Completed |
     | Future | Draft |
     | Current | Current |
     [ ]

     {#bulk-import-agile-azure__table_nm2_ddj_flb}
   * Sprints are not created in Agile Development 2.0 for the following conditions:
     * If the date fields of the iteration in Azure DevOps are empty.
     * If the iteration has a child iteration associated to it.
     * If the sprints have overlapping dates.
     {#bulk-import-agile-azure__ul_zcq_tdj_flb}
   * If two or more teams share a backlog iteration in Azure DevOps, a separate sprint record for each team is created in Agile Development 2.0.
   {#bulk-import-agile-azure__ul_ckk_ycj_flb}
{#bulk-import-agile-azure__steps_xvq_ck1_4kb}

## What to do next

[Schedule jobs to import data from Azure DevOps](https://www.servicenow.com/docs/sS6RcFunCYvy5YhQPf2zcw "Schedule jobs to automatically import new projects, teams, areas, work items, and sprints periodically from Azure DevOps into Agile Development 2.0.")
.

*[\>]: and then