Create a new automated test
task brazil Updated Sep 10, 2026 1 min read atf-create-test.md
Create a named automated test containing a series of steps to execute.
Before you begin
Role required: atf_test_admin or atf_test_designer
Procedure
-
Navigate to All > Automated Test Framework > Tests.
-
Click New.
-
On the Test new record form, enter a Name for your test.
The system identifies this test by this name wherever it displays a list of tests (for example, in the Tests module).
-
Enable parameterized testing to run a test multiple times with different test data for each run.
For more information, see Parameterized tests.
-
Enter a Description for your test.
-
Click Save.
The system creates a new test record and returns to the list of tests.
What to do next
Add steps to an automated test.
- Add a predefined list of steps (template) to an automated test
With test templates you can add a predefined list of steps to a test. Any list of steps that follows a set pattern makes a good candidate for a template. - Add steps to an automated test
Create a series of steps for an automated test to run in a specified order. - Change automated test step
If necessary, edit a test step after you create it. - Edit automated test step order
By default, steps execute in the order in which you created them. You can change this order by editing the Execution Order field.
Parent Topic:Building and running automated tests with the Automated Test Framework
59 lines · 3.2 KB
---
title: Create a new automated test
description: Create a named automated test containing a series of steps to execute.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/application-development/automated-test-framework-atf/atf-create-test.html
release: brazil
product: Automated Test Framework \(ATF\)
classification: automated-test-framework-atf
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Building and running automated tests with the Automated Test Framework, Automated Test Framework \(ATF\) test building and execution, Automated Test Framework \(ATF\), Testing and debugging applications, Classic app development, Building applications]
---
# Create a new automated test
Create a named automated test containing a series of steps to execute.
## Before you begin
Role required: atf\_test\_admin or atf\_test\_designer
## Procedure
1. Navigate to **All** > **Automated Test Framework** > **Tests**.
2. Click **New**.
3. On the Test new record form, enter a **Name** for your test.
The system identifies this test by this name wherever it displays a list of tests \(for example, in the Tests module\).
4. Enable parameterized testing to run a test multiple times with different test data for each run.
For more information, see [Parameterized tests](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/parameterized-tests.md).
5. Enter a **Description** for your test.
6. Click **Save**.
The system creates a new test record and returns to the list of tests.
## What to do next
[Add steps to an automated test](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/atf-create-step.md).
- **[Add a predefined list of steps \(template\) to an automated test](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/atf-use-template.md)**
With test templates you can add a predefined list of steps to a test. Any list of steps that follows a set pattern makes a good candidate for a template.
- **[Add steps to an automated test](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/atf-create-step.md)**
Create a series of steps for an automated test to run in a specified order.
- **[Change automated test step](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/atf-edit-test-step.md)**
If necessary, edit a test step after you create it.
- **[Edit automated test step order](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/atf-edit-step-order.md)**
By default, steps execute in the order in which you created them. You can change this order by editing the **Execution Order** field.
**Parent Topic:**[Building and running automated tests with the Automated Test Framework](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/atf-build-overview.md)
| title | Create a new automated test |
| description | Create a named automated test containing a series of steps to execute. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/application-development/automated-test-framework-atf/atf-create-test.html |
| release | brazil |
| product | Automated Test Framework \(ATF\) |
| classification | automated-test-framework-atf |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Building and running automated tests with the Automated Test FrameworkAutomated Test Framework \(ATF\) test building and executionAutomated Test Framework \(ATF\)Testing and debugging applicationsClassic app developmentBuilding applications |