Run manual tests

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

Run your manual tests and record the test results for each test step using Microsoft Test Runner. If you find an issue when testing, use Test Runner to create a bug. Test steps, screenshots, and comments are automatically included in the bug. You can use the web runner for web apps, or the desktop runner for desktop app data collection.


  • 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 or run manual or automated tests, you must have Basic access or higher.

To learn more, see Manual test access and permissions.

Run tests for web apps

  1. If you haven't already, create your manual tests.

  2. Select a test from a test suite and run it.

    Select and run a specific test

    Microsoft Test Runner opens and runs in a new browser.

  3. Start the app that you want to test. Your app doesn't have to run on the same computer as Test Runner. You just use Test Runner to record which test steps pass or fail while you manually run a test. For example, you might run Test Runner on a desktop computer and run your Windows 8 store app that you are testing on a Windows 8 tablet.

    Use Microsoft Test Runner to record your test results

  4. Mark each test step as either passed or failed based on the expected results. If a test step fails, you can enter a comment on why it failed or collect diagnostic data for the test.

    Mark test steps


    Any test step that has expected result is called a validation test step. Testers must mark a test step with a status if it is a validation test step. The overall result for a test case reflects the status of all the test steps that the tester marked. Therefore, the test case will have a status of failed if the tester marked any test step as failed or not marked.

  5. Create a bug to describe what failed.

    Submit a bug

    The steps and your comments are automatically added to the bug. Also, the test case is linked to the bug.

    If Test Runner is running in a web browser window, you can copy a screenshot from the clipboard directly into the bug.

  6. You can see any bugs that you have reported during your test session.

    Bugs logged

  7. When you've run all your tests, save the results and close Test Runner. All the test results are stored in Azure DevOps. How do I resume testing, or run one or more tests again?

  8. View the testing status for your test suite. You see the most recent results for each test.

    View test results

  9. Open a test and choose the test case in the Related Work section. Then use the Child links in the Related Work section of that work item to view the bugs filed by the tester.

    View bugs filed

Can I run tests offline and then import the results?

Run tests for desktop apps

If you want to collect more diagnostic data for your desktop application, run your tests using Test Runner client:

  1. Launch the test runner client from Azure Test Plans in Azure DevOps by choosing Run for desktop application from the Run menu.

    Launching the test runner client

  2. Download and install the Test Runner desktop client if you haven't already set it up:

    Download and launch Test runner


    Check that the Test Runner client is available for your platform. Currently, the Test Runner client is available only for x64.

  3. Choose Launch and start testing the same way as described above for web apps. See collect diagnostic data for the test for more information about data collection.

Can I run tests offline and then import the results?

Next step