Create a test plan and test suite

VSTS | TFS 2018 | TFS 2017 | TFS 2015

Create test plans to track manual testing for sprints or milestones. That way, you can see when the testing for a specific sprint or milestone is complete.

Test plans are used to group together test suites and individual test cases. This includes static test suites, requirement-based suites, and query-based suites. You can add individual test cases to a test plan without creating a test suite if you wish, but using a test suite provides a way to group test cases for separate testing scenarios within a single test plan.

To use the features described in this topic you must have either a Visual Studio Enterprise subscription, or have installed the Test Manager extension available from Visual Studio Marketplace.

Note: Stakeholders cannot create or manage test plans. You must have at least Basic access. See Default manual testing permissions and access.

Create a test plan

  1. If you haven't already, sign up for VSTS, create your project, and create your backlog.

  2. In VSTS, open your project.

  3. Go to the Test Plans tab of the Test hub. Create a test plan for your current sprint.

    In test plan explorer, open the New (+) list, then click Test plan

  4. Name the test plan. Check the area path and iteration. Then choose Create.

    Add test plan details, then click Create

Add a test suite and select backlog items to test

  1. Now add test suites for the backlog items that need manual tests. (These backlog items could be user stories, requirements, or other work items based on the setup of your project.)

    In test plan explorer pane, New (+) list, then click Requirement-based suite

    You use requirement-based suites to group your test cases together. That way, you can track the testing status of a backlog item. Each test case that you add to a requirement-based test suite is automatically linked to the backlog item.

  2. Add a clause to filter by the iteration path for the sprint. Run the query to view the matching backlog items.

    Add clause to filter by iteration, then run query to view results

  3. Select the backlog items that you want to test this sprint. Add them as requirements to your test plan by creating test suites from them.

    Select backlog items, then click Create suites

    Now you've created a requirement-based test suite for each backlog item.

Find a test plan

  • The Test Plans page shows a single test plan. Use the filter-icon icon to find the one you want to work with.

    Finding a test plan

Test plans, suites, and test cases are stored in VSTS and TFS as special types of work items.

See also

Next step