WiMigrator is a command line tool for migrating work items between VSTS/TFS projects
Switch branches/tags
Nothing to show
Clone or download
sferg-msft Merge pull request #41 from julioarruda/master
Changing appointments from VisualStudio or VSTS to new Brand (aka Azu…
Latest commit b18f871 Oct 14, 2018



WiMigrator is a command line tool designed with the following goals in mind:

  • Migrate work items from one Azure DevOps/TFS project to another
  • Real world example of how to use the WIT REST APIs
  • Cross platform support

Build Status


  • Migrate the latest revision of a work item or set of work items based on the provided query, including:
    • Work item links (for work items within the query results set)
    • Attachments
    • Git commit links (link to the source git commit)
    • Work item history (last 200 revisions as an attachment)
    • Tagging of the source items that have been migrated

Getting Started


  • Source Project on Azure DevOps or TFS 2017 Update 2 or later
  • Target Project on Azure DevOps or TFS 2018 or later
  • Personal access tokens or NTLM for authentication
  • Project Collection Administrator permissions required on target project
  • Process metadata should be consistent between the processes
    • Limited field mapping support is provided to map fields from the source to target account
    • Area/Iteration paths can be defaulted to a specific value when they don't exist on the target


WiMigrator supports the following command line options:

  • --validate validates that the metadata between the source and target projects is consistent
  • --migrate re-runs validation and then migrates the work items

Migration runs in two parts:

  • Validation
    • Configuration settings
    • Process metadata is consistent between projects
    • Identifies any work items that were previously migrated
  • Migration
    • Phase 1: Work item fields
    • Phase 2: Attachments, links, git commit links, history, target move tag
    • Phase 3: Source move tag

A sample configuration file is provided with documentation of all the settings

  • sample-configuration.json

Execution example:

dotnet run --validate configuration.json


  • Artifact links (other than git) are not migrated
  • Board fields are not migrated
  • Test artifacts (e.g. test results) are not migrated


This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.