Set test retention policies

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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 manage project-level test-related policies, you must be a member of the Project Administrators group.
  • To manage build pipeline object-level test retention policies, you must have the Edit build pipeline permissions set to Allow.

Set retention period for 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 in to your project ({Your_Organization}/{Your_Project}).

  2. Select Project settings.

  3. In the Test > Retention page, select a limit for how long you want to keep manual test data.

    Screenshot showing select test data retention limits.

Set retention policy for 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 in to your project ({Your_Organization}/{Your_Project}).

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

Set retention policy for automated test results not associated with builds

Clean up automated test results 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 described in Set retention period for test results earlier in this article.