Jira to Azure DevOps work item migration tool
The Jira to Azure DevOps work item migration tool lets you export data from Jira and import it as work items in Azure DevOps or Microsoft Team Foundation Server.
| Build | Quality | Release |
|---|---|---|
 |
Features
This tool lets you migrate work item from Jira to Azure DevOps or Microsoft Team Foundation Server. The tool has two parts, first Jira issues are exported to files then we import the files to Azure DevOps/TFS. We believe this is a good approach to migration since it allows you to export the data to migrate and validate it before importing it. It also makes it easy to migrate in batches.
Some of the capabilities include:
- Export Jira issues from Jira queries
- Map users from Jira to users in Azure DevOps/TFS
- Migrate work item field data
- Migrate links and attachments
- Migrate history
Getting the tools
- Download the latest release from GitHub and extract the files to your local workspace.
Getting started
The tools are provided as-is and will require detailed understanding of how to migrate work items between different systems in order to do a successful migration.
- See the migration process overview for information on how to get started.
- Read the article Jira to VSTS migration: migrating work items for more context of the process.
- Read the article Jira to Azure DevOps (VSTS or TFS) migration for a complete step-by-step walkthrough on a migration.
Support
If you need help with migrations, feel free to contact the team at Solidify for expert consulting services.
Support and bug reporting are managed via GitHub Issues. Please create a new issue and fill in the corresponding issue template.
Note: We do not answer Discussions, as these have less traceability than Issues. Discussions are instead reserved for community discussions.
Jira Azure DevOps Migrator PRO
The Jira Azure DevOps Migrator PRO offering from Solidify offers more features and utilities to further increase your migration capabilities and streamline the migration workflow. Contact us for more information
Features
Jira Azure DevOps Migrator PRO contains all the features in the Community Edition, plus the following additional functionality:
- Priority support
- Composite field mapper (consolidate multiple Jira fields into a single ADO field)
- Migrate Releases and the fixes version field
- Correct any hyperlinks to Jira Issues in text fields such as Description, Repro Steps and comments, so that they point to the correct Work Item in Azure DevOps.
- Select any property for object- and array-type fields for mapping.
- Utilities for automating user mapping between Jira and Azure DevOps
- Utilities for automatically generating the Jira Azure DevOps Migrator configuration file, thus enabling you to get started migrating faster
- Utilities for viewing the Jira workflow and assisting with field and state mapping
- Migrate Jira test data to Azure DevOps Test Plans, including the QMetry, Zephyr and Xray frameworks
- Migrate Confluence pages to Azure DevOps Wikis
FAQ - Frequently Asked Questions
Telemetry
In order to improve the tool we collect some telemetry data using Microsoft Application Insights. See Telemetry for more details, including how to disable telemetry collection.
Contributions are welcome
Here is how you can contribute to this project:
- Fork the repo and submit pull requests for bug fixes and features
- Submit bugs and help us verify fixes
- Discuss existing issues/proposals
- Test and share migration configurations
Please refer to Contribution guidelines and the Code of Conduct for more details, including how to build and debug the tools locally.
Supported versions of ADO/Jira
The Jira to Azure DevOps work item migration tool is offically supported on the following platforms:
- Atlassian Jira Cloud
- Atlassian Jira Server
- 7.x
- 8.x
- 9.x
- Azure DevOps Services
- Azure DevOps Server
- 2022
- 2020
- 2019
- Team Foundation Server 2018 update 3