Import work items from Azure DevOps to Agile Development 2.0

  • Release version: Australia
  • Updated March 12, 2026
  • 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

    Procedure

    1. Navigate to All > Agile Azure DevOps Integration > Azure 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:
        State in Azure DevOps State in Agile Development 2.0
        Past Completed
        Future Draft
        Current Current
      • 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.
      • 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.

    What to do next

    Schedule jobs to import projects, teams, areas, and work items from Azure DevOps

    .