logo
search
Others

How to Bulk Import Azure DevOps Test Cases from Excel

Maira MehtabMaira Mehtab Sep 21, 2026 869 views

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.

Formatting data in an Excel spreadsheet
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.
Before you start

Ensure you have the necessary permissions in your Azure DevOps project to create and modify Test Cases before attempting a bulk import.

Solution 1Recommended

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.

1
Access the Official Guide

Visit the Microsoft Learn page for 'Bulk import or export of test cases in Azure Test Plans' to review the current supported requirements.

2
Prepare Your Spreadsheet

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'.

3
Format Test Steps

Format your test steps according to the documentation requirements, ensuring 'Action' and 'Expected Result' fields are clearly defined.

4
Execute Import

Use the import feature within Azure DevOps or the Azure DevOps Office Integration Excel add-in to upload your prepared spreadsheet.

Azure Q&A Support: If you encounter specific mapping errors or add-in failures during the import process, consider posting your specialized questions in the Microsoft Azure Q&A forums.
Free Microsoft Office alternative

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. 1. Download and Install: Download WPS Office for free from the official website and follow the installation prompts.
  2. 2. Open Your Spreadsheet: Launch WPS Spreadsheet and open your .xlsx or .csv test case file to begin preparing your data.
  3. 3. Format and Save: Organize your columns to match Azure DevOps requirements, then save the file in standard .csv or .xlsx format.
Fully compatible with Microsoft Excel (.xlsx, .csv) formats required for DevOps imports.Easily organize and format Azure DevOps test case columns and steps.Lightweight and fast, making it ideal for managing massive datasets and test plans.Familiar user interface ensures a seamless transition with zero learning curve.
microsoft office alternative - wps office

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.