---
sourceDocument: Brazil Telecommunications, Media, and Technology
sourceDocumentLink: https://www.servicenow.com/docs/r/telecom-media-technology

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Telecommunications, Media, and Technology

ft:clusterId :

    - telmt

bundleId :

    - telmt

workflow :

    - Customer and Industry


---

# Retire

# Retire test definitions {#ariaid-title1}

Release version: Brazil  
Updated October 13, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Retire published test definitions that you no longer use, so that new test runs can't reference them.

## Before you begin

The test definitions must be in the Published state.

Role required: sn_st_mgmt.test_def_manager

## About this task

A retired test definition can't be changed, and it can't return to an earlier state. See [Test definitions in Service Test Management](https://www.servicenow.com/docs/t4STlHAHnKqPu1DgzNFPWQ "A test definition specifies the parameters, metrics, and threshold rules for a service test. Use test definitions to identify the root cause of service problems across service types, product models, and inventory."). You can retire one test definition from its form, or several from the list.

## Procedure

1. Navigate to AllService Test ManagementTest DefinitionsAll.
2. Retire the test definitions.
   * To retire one test definition, open it, select Retire, and then confirm.
   * To retire several test definitions, select the check box for each one. In the list actions, select Retire, and then confirm.

## Result

The state of each test definition changes from Published to Retired.

A test definition linked to a published test definition as a related test definition can't be retired. On the form, an error appears. From the list, the others are retired and a message lists the skipped definitions. In this case,
remove the relationship first. See [Define the relationship between the test definitions](https://www.servicenow.com/docs/A06oXUjAmO5yfn1PvRw~ag "Define relationships for a test definition to connect and associate it with other test specifications. This process ensures comprehensive testing coverage and that the tests are aligned with the testing goals.").

## What to do next

To archive retired test definitions, see [Archive test definitions](https://www.servicenow.com/docs/SHydCHfg8mYToTYufmWqiw "Archive retired test definitions in the Service Test Management application to take them out of the working list.").

*[\>]: and then


