How to Bulk Import Azure DevOps Test Cases from Excel
Question details
The user is looking for guidance on bulk importing test cases and test steps into Azure DevOps using an Excel spreadsheet and the Excel add-in.

- Product
- Microsoft Excel / Azure DevOps
- Device & OS
- not provided
- Scenario
- Preparing and importing a large volume of test cases and steps from an Excel file into Azure Test Plans.
- Observed behavior
- The user needs to find the proper documentation, formatting requirements, and best practices to ensure a successful data import into Azure DevOps.
Ensure you have the necessary permissions in your Azure DevOps project to create and modify Test Cases before attempting a bulk import.
Use Official Microsoft Documentation for Azure DevOps Import
Review the official Microsoft guidelines to properly format your Excel spreadsheet and execute the bulk import into Azure Test Plans.
Importing test cases into Azure DevOps requires strict adherence to column mapping, work item types, and test step formatting. Microsoft provides detailed documentation to guide users through bulk importing and exporting test cases.
Visit the Microsoft Learn page for 'Bulk import or export of test cases in Azure Test Plans' to review the current supported requirements.
Ensure your Excel spreadsheet columns properly match the Azure DevOps test case fields. Verify that the 'Work Item Type' is explicitly set to 'Test Case'.
Format your test steps according to the documentation requirements, ensuring 'Action' and 'Expected Result' fields are clearly defined.
Use the import feature within Azure DevOps or the Azure DevOps Office Integration Excel add-in to upload your prepared spreadsheet.
Prepare Your DevOps Spreadsheets with WPS Office
While the Azure DevOps Excel add-in is part of the Microsoft ecosystem, you can seamlessly prepare, organize, and format your bulk import CSV or XLSX files using WPS Office. It is a highly compatible, free, and lightweight alternative to Microsoft Office.
- 1. Download and Install: Download WPS Office for free from the official website and follow the installation prompts.
- 2. Open Your Spreadsheet: Launch WPS Spreadsheet and open your .xlsx or .csv test case file to begin preparing your data.
- 3. Format and Save: Organize your columns to match Azure DevOps requirements, then save the file in standard .csv or .xlsx format.

Frequently Asked Questions
Can I use a CSV file to bulk import test cases into Azure DevOps?
Yes, Azure DevOps natively supports importing test cases from CSV files directly via the web portal. Preparing your test cases in a CSV format is often easier and doesn't strictly require the Excel add-in.
Why are my test steps not importing correctly?
Test steps must follow a specific formatting structure in your spreadsheet. Ensure your columns map exactly to the Azure Test Plan requirements and that you haven't merged cells inappropriately.
Where can I get help for Azure DevOps import errors?
You can post specialized questions with detailed error logs to the official Microsoft Azure Q&A platform for dedicated technical support.




