Control how long to keep test results in VSTS

VS 2017 | VS 2015 | VSTS | TFS 2018 | TFS 2017 | TFS 2015

Running tests, especially automated ones, generates lots of data. To keep your test system responsive and performing well, have a policy to clear test results that you don't need anymore. Delete automated test results when you delete your builds. You can keep manual test results while you're still reviewing them, for example, up to a year.

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.

Manual test results

To delete manual test results after a specific number of days, set the retention limit at the project level. Visual Studio Team Services (VSTS) keeps manual test results related to builds, even after you delete those builds. That way, build policies don't delete your test results before you can analyze the data.

  1. Sign to your VSTS account ( You'll need at least project administrator permissions.

  2. Go to your project.

  3. Go to the project control panel.

    Project control panel

  4. Select a limit for how long you want to keep manual test data.

    Select test data retention limits

Automated test results

Automated test results associated with builds

By default, VSTS keeps automated test results related to builds only as long as you keep those builds. To keep test results after you delete your builds, edit the build retention policy. If you use Git for version control, you can specify how long to keep automated test results based on the branch.

  1. Sign to your VSTS account ( You'll need at least build level permissions to edit build definitions.

  2. Go to your project. Find and edit your build definition.

    Build definition

    By default, test results are deleted when the build is deleted.

    Test results are deleted when builds are deleted

  3. If you use Git, and you have more than one branch, set the branch filter to delete test results and builds in one branch. Meanwhile, you can keep test results in another branch, even though you delete the builds in that other branch.

    Delete test results by branch

Automated test results not associated with builds or orphaned from deleted builds

To clean up automated test results that are left over from deleted builds or test results that aren't related to builds, for example, results published from external test systems, set the retention limits at the project level. Learn more

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.