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


---

# Working with scheduled test suites

# Working with scheduled test suites {#ariaid-title1}

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

You can schedule a test suite to run at a specified date and time.  
To schedule a test suite, you need three components:

* a test suite record
* a schedule record specifying when you want the system to run the test suite
* a scheduled suite run record that associates the test suite to run with the schedule for running it
{#atf-sched-suites__pbf_3bt_bz}  
With this model, you can associate a schedule with many different test suites and vice-versa.  
Note:  
You can schedule only test suites, not individual tests. Scheduled tests will only run if there is an open Scheduled Client Test Runner page matching the scheduled suite's browser conditions. Scheduled tests cannot run on a machine that is locked, powered down, or does not already have the browser open.

The watchlist on the test suite run record also allows you to specify users to receive an email
when the system finishes executing the test suite run.

If the test suite contains one or more form steps (steps involving a user interface), you must
ensure that a scheduled client test runner is actively running in a browser when the schedule
triggers the suite run.  
Note:  
See [Browser recommendations and requirements](https://www.servicenow.com/docs/frcpA6a_l_pZrHyMCq9O_g#atf-test-runners__kvv_h25_gx) for recommendations and requirements for running the client test runner.

For step-by-step instructions on how to schedule a test suite, see [Schedule an automated test suite](https://www.servicenow.com/docs/3sSvpzyhf6TQPhtE_ZsAwg "Schedule one or more test suites to run at a specific date and time.").

## Designate users to receive email when system finishes running a scheduled test
suite {#ariaid-title2}

You can designate users to be notified when a scheduled test suite finishes
executing.

### Before you begin

Role required: atf_test_admin

### Procedure

1. Navigate to the scheduled test suite run record.
2. Add to the record's watchlist all users you want the system to notify when this scheduled test suite run completes. {#atf-set-sched-email-recipients__hs4_gvp_ty}

## Automated Test Framework scheduled test suite completed email {#ariaid-title3}

When the system completes executing a scheduled test suite, it sends an email to users
on the Scheduled Suite Run record watchlist. This email contains information and links to
further information about the Scheduled Suite Run and its results.
Note:  
Email functionality must be enabled in order to send an email.

### Suite Stats

The Suite Stats section of the email reports the number of suites and individual tests
broken down by result status: Failed (F), Error (E), Skipped (S), Canceled (C), or Passed
(P). For a description of what each status means, see [Test suite results record](https://www.servicenow.com/docs/czOXP4JDFV84Lg3roGCIYg "The Test Suite Results record displays information about the results of one execution of one test suite.").

### Test Suite Results

The Test Suite Results section of the email reports test suite results over time.  
Note:  
By default, this report includes only suites with failed tests, but you can change this setting with the Email properties field on the [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.") page. If set to default, only the failed tests within a test suite are reported.
Figure 1. Preview email report  
Note:  
ATF reports only recent tests results on the email report. All the previous test results still exist if it's within the set retention time limit. See [Table cleanup](https://www.servicenow.com/docs/c4o~T3LLARpa40a6oF9ajQ "The Table Cleanup module opens a list of records specifying the retention policies for test result and test suite result tables and the records within them. From this module, you can view and modify these policies.") for more information on retention policy for ATF test results. {#atf-sched-email-content__b5z_tbq_ty__entry__3}

| Letter | Color | Description |
|:-|:-|:-|
| F | red | Test failed |
| P | green | Test passed |
| S | white | Test skipped |
| C | white | Test canceled |
| E | orange | Test has error |
[Table 1. Test Results Key]

{#atf-sched-email-content__b5z_tbq_ty}

Each entry acts as a link to the result record for that run. If you point the mouse
to any of these entries, the system displays the parent suite number, the parent suite end
time, and the test result output.

### Properties affecting email content

On 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.") form, you can set options affecting the format and content of the email.