---
title: Create a parameterized test
description: Build a test that uses variables to store test data.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/application-development/automated-test-framework-atf/create-parameterized-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: [Parameterized tests, 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 parameterized test

Build a test that uses variables to store test data.

## Before you begin

Role required: atf\_test\_admin, atf\_test\_designer, or admin

## Procedure

1.  Navigate to **All** > **Automated Test Framework** > **Tests**.

2.  Click **New**.

    A blank Test record opens.

3.  On the form, fill in the fields.

    |Field|Description|
    |-----|-----------|
    |Name|Enter a name for the test.|
    |Active|Enable|
    |Enable parameterized testing|Enable|
    |Description|Enter a description for the test.|

4.  Click **Save.**

    Parameterized testing related lists appear.

5.  Create a parameter to hold test run data.

    A parameter is a variable that stores a particular type of test data. Each parameter has a unique label and a data type. For example, you can create a parameter to store the Sys ID of a reference field or the integer value of a choice field.

    1.  In the Parameter Definitions related list, add a parameter.

        -   **Add Exclusive Parameters**: Adds a parameter available to this test only.
        -   **Add Shared Parameters**: Adds a parameter available to any parameterized test.
    2.  Define the name of the variable and the data type.

        When creating parameters for a form, the parameter data type must match the field data type. For example, if you are creating a parameter to test a reference field on a form, you must create a parameter of type Reference. For more information on ServiceNow AI Platform data types, see [Field types](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-administration/r_FieldTypes.md).

    3.  Click **Submit**.


## What to do next

[Add a parameter to a test step](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/add-parameterized-value-to-step.md)

**Parent Topic:**[Parameterized tests](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/parameterized-tests.md)