Create manual test cases

Last Update: 7/25/2017

Visual Studio 2017 | Visual Studio 2015 | TFS 2017 | TFS 2015 | Previous version

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

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

  2. Select a requirement-based test suite, and then create a test case for that suite.

    Select the test suite for a backlog item, then choose New | New Test Case

    The test suite that you selected was created from a backlog item. When you add a test case to this kind of suite, the test case is linked automatically to the backlog item.

  3. Add test steps with actions and expected results so that any team member can run the test. You can add attachments to a step if you want.

    Create steps for a new manual test case

    Now you've created a test case that you can run.

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

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

    On the test suite shortcut menu, choose Assign testers to run all tests

    After you select the testers, you can email them so they know the tests are ready for them to run. (You just need Basic access to run tests from Visual Studio Team Services.)

    Assign testers to run all tests and send emails to them

Try this next


Q: Can I rename or permanently delete test cases?

A: Yes. Open the test case from its shortcut menu.

Open a test case for editing

Then rename it.

Rename a test case

Or permanently delete it.

Delete a test case

See also Delete test artifacts

Q: Can I add an extra line to a test step?

A: Yes, press Shift+Enter in the action or expected results field to add an extra line.

Q: How do I insert a test step into a test case?

A: Select a test step. Press Alt+P to insert a new test step above the selected step.

Q: Is there a way to quickly add multiple test cases at the same time?

A: Yes, use the grid view when you add test cases to the test suite.

Create new test cases using the grid

On the grid shortcut menu, you can add, delete, or clear rows.

Use the grid's shortcut menu to insert, delete, or clear rows

Switch between Grid and List views using the View menu at the right of the window.

Use the View menu to switch between List and Grid views

Note: Do not use the Team plugin for Excel to add or update test case work items. Excel cannot parse the format used to store test steps, and in some cases this may affect the formatting of the test case work items.

Q: Can I bulk edit multiple test cases?

A: Yes, switch the view from List to Grid. The grid shows all the test cases for the current test suite and all the test steps for those cases. This is a helpful view if you want to review your test cases with other team members. When you review, you can update and add new test cases.

To change from list to grid view, choose List

Or, you can filter and sort the test cases in list view. Then select just the ones that you want to bulk edit using the grid.

Select test cases in listview to bulk edit in grid view

To return to the test suite view, switch the view from Grid back to List.

Q: Can I copy, clone, and move test plans and test suites?

Yes, install the Test Case Explorer extension from Marketplace.

Q: Can I copy test cases and test steps from an existing Excel worksheet?

A: Yes, copy the columns from Excel that you want to use for the title, action, and expected results fields. No column formatting, other than multiline, is copied from the worksheet. Paste these columns into the grid view, edit if necessary, and save them. (This is supported only with Internet Explorer and Chrome browsers.)

Save copied test cases in grid view

Q: Can I copy test cases from the grid to an Excel worksheet?

A: Yes, copy the data from the grid and paste it into your Excel worksheet. No test step formatting, other than multiline, is copied into the worksheet. (This is supported only with Internet Explorer and Chrome browsers.)

Q: Can I edit other fields in the grid view?

A: Yes, in List view use the column options to select the fields in the test case work item.

Use column options to select fields to edit

You can then view and edit these fields when you switch to the grid view.

Q: Can I reorder test cases in a test suite?

A: Yes, you can reorder manual test cases in static suites, requirement-based suites, and query-based suites. Choose Order tests on the tool bar, then drag and drop one or more tests. Or open the shortcut menu for a test to move it to the top or to another position. After reordering the tests, you can sort them by the Order field and then run them in that order with the web runner.

Order test cases

Q: Can I tag test cases so that I can see only tests with specific tags?

A: Yes, you can tag test cases in a suite with any tag that you want. For example, tag all the tests related to login so that you can rerun these tests if a bug is fixed for the login page. Then you can filter on that tag from the Test hub.

You can add and edit tags when you edit a test case, or bulk edit tags in the grid view. You can also create suites based on queries when you use tags.

In Test hub, on the Test Plan tab, choose or add tags from the test case pane

Q: Can I share test steps between test cases?

A: Yes, choose the steps that you want to share. Find out more about sharing test steps.

Create shared test steps

Q: Can I add parameters to a test case so it can run multiple times with different data?

A: Yes, choose a test step, and then add the parameter. Find out more about repeating test steps with different data.

Add parameter to test step

Q: Can I share parameter data between test cases?

A: Yes. That way, test cases with the same parameters can run with same data, so you get consistent results. To share parameter data, convert your existing parameters to shared parameters.

In the Parameters section, choose Convert to shared parameters

After you create a shared parameter set, open another test case, and add the shared parameter set to that test case. Find out more about sharing parameters.

Add, edit, and rename your shared parameter sets on the Parameters tab. In the test cases pane, view the test cases that use those parameters.

On the Parameters tab, turn on the test cases pane to view tests cases with shared parameters

Each shared parameter set is a work item. On the Properties tab, you can view or make changes to this work item. For example, you can assign owners and track changes.

Q: Can I import parameter values from an Excel spreadsheet to my shared parameter sets?

A: Yes, copy the data from your Excel spreadsheet and paste it into your shared parameters grid. You can also copy the data from your grid back into Excel, if necessary.

Q: How can I find out if a test case was added to other test suites?

A: Select a test case, then view the test suites details. The Associated test suites pane shows you any test suite for any test plan that contains this test case. This includes all team projects.

Click the associated test suite to view it. To view the team project and the test plan for that test suite, move your pointer over the test suite.

On Tests tab, click details pane. Select test suites in the test details pane

Q: What happens when I delete a test case from a requirement-based test suite?

A: The test case still exists in your team project, but the test case is removed from the test suite. Also, it's no longer linked to the backlog item for that test suite.

Q: Why do I see the wrong test suite and tests when I click 'View Tests' from the notification email about tests that are assigned to me?

A: This might happen if you were prompted to enter sign-in credentials for Visual Studio Team Services when you clicked this link. Without signing out from Visual Studio Team Services, click 'View Tests' again to see the correct test suite and tests.

See also

Help and support

Report any problems on Developer Community, make suggestions on UserVoice, get advice on Stack Overflow, and get support via our Support page. We look forward to your feedback.