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


---

# Add steps to an automated test

# Add steps to an automated test {#ariaid-title1}

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

Create a series of steps for an automated test to run in a specified
order.

## Before you begin

You must create a test before you can add steps to the test.

Role required:
atf_test_admin or atf_test_designer

## About this task

This procedure lets you add one step at a time. You can also add a batch of steps at once. For more information, see [Add a predefined list of steps (template) to an automated test](https://www.servicenow.com/docs/DioicS1kdSPLhNVByT5Lgg "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.").

## Procedure

1. Navigate to AllAutomated Test FrameworkTests. {#atf-create-step__conref-add-step-01}
{#atf-create-step__conref-add-step-01}
2. Click the test that should contain the new test steps. {#atf-create-step__conref-add-step-02}
{#atf-create-step__conref-add-step-02}
3. In the Test Steps related list at the bottom of the Test form, click Add Test Step. {#atf-create-step__conref-add-step-03}
{#atf-create-step__conref-add-step-03}
4. From the left panel of the Add Test Step form, select the test step category, or select All Steps to view all available test steps for all test categories.  
   For example, if selecting a specific test step category, select Form for form-related test steps, Application Navigator to test application menu or module visibility, or Server for tests executed on the server.  
   Note:  
   When selecting certain types of server tests, you can specify whether a positive or negative test result constitutes a successful test outcome. For more information, see Assert type in [Exploring Automated Test Framework](https://www.servicenow.com/docs/VPxGPoKOWTBxIAdcA5dNcw "The Automated Test Framework helps you ensure the integrity of your instance by enabling the creation and execution of automated tests following any changes."). {#atf-create-step__conref-add-step-04}
{#atf-create-step__conref-add-step-04}
5. Click the type of test step you want to select.  
   For example, if you select the Form category, select Set Field Values to set the field values on a form.

   Start any sequence of steps that work with forms with the
   Open a new form or Open an existing form step. Close with the Submit form
   step.
   {#atf-create-step__conref-add-step-05}
{#atf-create-step__conref-add-step-05}
6. If applicable, from the Insert after drop-down list, select the step that you want to precede this step.  
   If this is the first step in a test, the Insert after drop-down list does not appear. {#atf-create-step__conref-add-step-06}
{#atf-create-step__conref-add-step-06}
7. Click Next. {#atf-create-step__vcf_f1z_ww}
{#atf-create-step__conref-add-step-07}
8. From the Table list on the Add Test Step form, select the table that you want to test in this step. {#atf-create-step__conref-add-step-08}
{#atf-create-step__conref-add-step-08}
9. **Optional:** In the Execution Order field, enter an integer representing the order in which you want the test to execute this step.  
   For more information on Execution Order, see [Edit automated test step order](https://www.servicenow.com/docs/mVp~K3TFwG3UN7~BB6Wu8g "By default, steps execute in the order in which you created them. You can change this order by editing the Execution Order field."). {#atf-create-step__conref-add-step-09}
{#atf-create-step__conref-add-step-09}
10. Fill in the fields that apply to this step.  
    For instructions, see [Automated Test Framework (ATF) test step categories](https://www.servicenow.com/docs/sJ6~3h0z0dKX5RgVTmIm7Q "Find test steps for a particular user interface or ServiceNow AI Platform feature.").

    Some steps return output values that you can pass to the inputs for a subsequent step. For more information, see [Pass values from one automated test step to another](https://www.servicenow.com/docs/su7DkmaiXfjdGpwC2Wcyeg "Assign a form field the value of an output variable returned from a previous step.").
    {#atf-create-step__conref-add-step-10}
{#atf-create-step__conref-add-step-10}
11. Click Submit.  
    The system creates the step and displays the test record. {#atf-create-step__conref-add-step-11}
{#atf-create-step__conref-add-step-11}
12. Repeat Steps 3 through 11 to add additional steps for this test. {#atf-create-step__conref-add-step-12}
{#atf-create-step__conref-add-step-12}

## What to do next

[Run an automated test](https://www.servicenow.com/docs/yA5AzP3JsX7LRKLVKNwZbg "After creating an automated test, run it on a non-production instance.").
**Related concepts**   

* [Automated Test Framework use case examples](https://www.servicenow.com/docs/w46AqCTablktNTv9PMJ8vQ "Use cases can help you construct tests for common scenarios.")

*[\>]: and then