Create manual test cases

Azure Test Plans | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-2015

Create manual test cases to check that each of the deliverables meet your users' needs. Organize your test cases by adding them to test plans and test suites. Then choose which testers you want to run the tests.

For an overview of test artifacts, see Test objects and terms.


Test iterations are designed to support data-driven scenarios, not workflow-driven scenarios. From a best practice perspective, if you have two test scenarios where the workflows are different, consider creating separate test cases. Also see FAQs for manual testing.


  • You must connect to a project. If you don't have a project yet, create one.

  • You must be added to a project. To get added, Add users to a project or team.

  • To view test-related work items, you must have Basic access or higher and permissions to view work items under the corresponding Area Path.

  • To add test plans and test suites, manual test cases, delete test artifacts, and define test configurations you must have Basic + Test Plans access level or have one of the following subscriptions:

  • To add or edit test-related artifacts, you must have the following permissions:

    • To add or modify test plans, test suites, test cases, or other test-based work item types, you must have Edit work items in this node permission set to Allow under the corresponding Area Path.
    • To modify test plan properties such as build and test settings, you must have Manage test plans permission set to Allow under the corresponding Area Path.
    • To create and delete test suites, add, and remove test cases from test suites, change test configurations associated with test suites, and modify a test suite hierarchy (move a test suite), you must have Manage test suites permission set to Allow under the corresponding Area Path.

To learn more, see Manual test access and permissions.


If you're new to using Azure Test Plans, review Navigate Test Plans to understand how to use the user interface to access select functions.

Create test cases

  1. If you haven't already, create a test plan and requirement-based test suites.

  2. Select a requirement-based test suite. In the right-hand pane, choose + (New) and then choose New test case.

    Select the test suite for a backlog item and adding a new test case

    The test suite shown here was created from a User Story work item in the team's backlog board. When you add a test case to this kind of suite, the test case is automatically linked to the backlog item. To create test cases this way, open the shortcut menu for the work item and choose Add test.

  3. Choose the Click or type here to add a step link and add test steps with a description of the action required to carry out the test and the expected results so that any team member can run the test. You can add attachments to a step if you want. Repeat until you have added all the steps for the test. Now you've created a test case that you can run.

    Creating the steps for a new manual test case

    How can I find an existing test case within a test plan?

    How do I add multiple test cases at the same time?


You can create a test case that automatically links to a requirement—User Story (Agile), Product Backlog Item (Scrum), Requirement (CMMI), or Issue (Basic)—when you create a test from the Kanban board. To learn more, see Add, run, and update inline tests.

Assign testers

  1. You can reassign test cases so that another tester can run them. Select the tests that you want to reassign. Then open the shortcut menu (choose the "..." ellipses or right-click) and select the tester you want to run the tests.

    Reassigning tests to a different tester

    Or, you can assign all the test cases in a test suite to multiple testers. This is useful for acceptance testing. Open the shortcut menu for the test plan and choose Assign testers to run all tests.

    Assigning testers to run all tests

  2. Add or remove testers from the list. After you select the testers, tick the Send email checkbox and edit the message as required so they know that tests are ready for them to run.

    Send emails to testers

    The email contains a link that testers can open to see the list of assigned tests. Testers need just Basic access to run tests from Azure Test Plans.

Next step