---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/application-development

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Manage test client runners policies

# Manage status and retention policies for automated test client runners {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Modify how often active client test runners report in to the system and how long the
system retains records for inactive client test runners.

## Before you begin

Role required: atf_test_admin

## About this task

When you start a [client test runner](https://www.servicenow.com/docs/frcpA6a_l_pZrHyMCq9O_g "If an automated test includes steps that involve a form or any other user-interface (UI) element, it runs those steps in a browser tab or window called a test runner or client test runner."), the system registers that runner as active, meaning that it is either running a test or is available to run a test. While the runner is active, it reports in to the system at a specified interval. If the runner does not report in at the expected time, the system marks the runner as inactive. After a period of time the system deletes the runner. This task enables you to modify the [Automated Test
Framework properties](https://www.servicenow.com/docs/CZE3CyRbBHjwd7CqM7RFqg "On the Properties form, you can set parameters that control how the system executes automated tests and test suites.") that control these intervals.

## Procedure

1. Navigate to AllAutomated Test FrameworkAdministrationProperties.
2. Navigate to the Test Runner Properties section.
3. To set the interval at which active client test runners report in to the system, enter the reporting interval in seconds in the Test runner heartbeat interval field.
4. To set the period of time a test runner can remain inactive before the system deletes it, enter the period of time in seconds in the Test runner timeout field. {#atf-modify-retention-test-clients__ozr_qq2_5w}
5. Click Save. {#atf-modify-retention-test-clients__ftb_xp2_5w}
**Related concepts**   

* [Working with client test runners](https://www.servicenow.com/docs/frcpA6a_l_pZrHyMCq9O_g "If an automated test includes steps that involve a form or any other user-interface (UI) element, it runs those steps in a browser tab or window called a test runner or client test runner.")  
**Related reference**   

* [Active manual test runners](https://www.servicenow.com/docs/DMmvoyH3klngdHxE1bnanA "View the client test runners table filtered to show only those runners available to run manually-started tests.")
* [Active scheduled test runners](https://www.servicenow.com/docs/pLWXBHI3hyiBrXPSE0v1xg "View the client test runners table filtered to show only those runners available to run tests to be started by a schedule.")

*[\>]: and then