Control how long to keep test results

Azure Test Plans | Azure DevOps Server 2019 | 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 all the features described in this topic you must have either an Enterprise, Test Professional, or MSDN Platforms subscription; or have installed the Test Manager extension for Azure Test Plans available from Visual Studio Marketplace. See Manual testing permissions and access.


Manual test results

To delete manual test results after a specific number of days, set the retention limit at the project level. Azure DevOps 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 into Azure DevOps. You'll need at least project administrator permissions.

  2. Go to your project and then open the project settings page.

  3. In the Test | Retention page, 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, Azure DevOps 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 into Azure DevOps. You'll need at least build level permissions to edit build pipelines.

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

    Build pipeline

  3. Open the Retention page. Modify the default policies as required, or add new policies.

    Delete test results by branch

    If you use Git, and have more than one branch, set the branch filter to delete test results and builds in specific branches as required. You can keep test results in other branches, even though you delete the builds in these branches.

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 as shown here.

See also

Help and support

Report any problems on Developer Community, get advice on Stack Overflow, and get support via our Support page.