---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Re-run failed tests in an automated test suite

# Re-run failed tests in an automated test suite {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Re-run failed tests within a test suite without rerunning the entire suite.

## Before you begin

Role required: atf_test_admin, atf_test_designer, or admin

## About this task

The Re-run failed tests button appears on the Suite Result form and on the Suite Execution Progress Viewer after a suite with failed tests completes. It does not appear if test execution is disabled, the suite is deactivated, the suite passed, or the user does not have one of the required roles.

The Re-run failed tests button re-runs all non-passing tests, which includes tests with the following status: canceled, skipped, failure, and error. It does not include the test results with a
Success with warning(s) status.

## Procedure

1. Navigate to either the suite result form or suite execution progress viewer for the completed suite that had failed tests.
2. Click Re-run failed tests.  
   If the re-run tests include a form step (any step involving a UI) or other kinds of [UI test steps](https://servicenow-prod.fluidtopics.net/8Z9mdUYgpKuwgMSKFSb9~Q "Test user interfaces by mimicking user actions and interacting with the visible components of a page."), the [Pick a Browser](https://servicenow-prod.fluidtopics.net/MowfYHt0cQxkNUHtEOESRQ "If the test or test suite you are running contains steps that work with a form (any step involving a UI), or any other UI test step element (such as Automated Service Catalog test steps), work with the Pick a Browser dialog.") dialog appears before executing the tests.
3. In the dialog box, choose among any currently running test clients or start a new runner.  
   If the re-run tests include only server test steps, the system executes the tests without displaying the Pick a Browser dialog. For more information, review [Browser recommendations for all tests and suites](https://servicenow-prod.fluidtopics.net/RCkgkemnippD_sUkq2mTnw#atf-test-runners__kvv_h25_gx) and [Server test steps](https://servicenow-prod.fluidtopics.net/EaJztQr1sv02IzB3LQOKqg "Test business logic and background processes by performing operations on the server.").

## Result

The system re-runs the failed tests.

* The system creates a new suite result hierarchy for the re-run tests. The Progress Workers, Test Result, and Test Suite Result forms show the same suite hierarchy as the previous test suite. They do not include the tests or suites that passed in a previous run.
* If you delete or deactivate a child suite or test that failed, and then re-run it, the system does not execute that suite or test in the re-run.
* If you add a child suite or test to the suite to a failed test, and then re-run it, the system does not execute the added suite or test in the re-run.
{#atf-rerun-tests__ul_eht_w2x_h1b}

## What to do next

To view the results from the previous run of a test or suite, click Previous test result on the [test result form](https://servicenow-prod.fluidtopics.net/40xxM_hBdoBdQM3aTH7wFg "A Test Results record contains detailed results information about one test execution. Client Error Details and Failure Details sections appear when a test fails due to error conditions, and include detailed error information you can use for troubleshooting purposes.") or Previous suite result on the test [suite result form](https://servicenow-prod.fluidtopics.net/NWQJqCKCu91S1QDmv7JBPA "The Test Suite Results record displays information about the results of one execution of one test suite."). These fields only appear for tests and suites that have been re-run.