Training tests with DataTables
How to train and edit tests with DataTables
This guide explains how to set up DataTable scenarios for training in browser tests and API tests.
Browser tests
New tests
If you are creating a new browser test, you can choose a DataTable for training under the Show advanced options section. Make sure that Train with DataTable is toggled on.

Associating a new browser test with a DataTable
When you open the new test in the mabl Trainer, the test will use the values from the first scenario in the DataTable. If you want to use values from a different DataTable scenario, save your changes and follow the steps for existing tests.
Existing tests
When editing existing tests, you can select a specific DataTable scenario for training by following these steps:
- Navigate to the Test Details page of the test you would like to edit.
- Click on the Edit steps button. The Edit Test Configuration modal will appear.
- Make sure the toggle "Populate data-driven variables from a DataTable" is enabled.
- Select the DataTable and specific scenario that you would like to train with.
- Click the Launch Trainer button.

Training a browser test with a specific DataTable scenario
You may also launch the mabl Trainer with the DataTable scenario used in a specific test run. From the Test Output page, click on the Edit test button and select either "Launch Trainer" or "Launch and replay to failed step." This option makes it easier to investigate and debug a test run.

Launch a training session to the DataTable scenario used during a test run
Checking scenario values
If you want to check the scenario values while training a browser test, click on the {x} variables button and select View all variables and their current values.
The View Variables modal will show the DataTable scenario and values that are used for the current training session.

DataTable scenario values in the View Variables modal
API tests
To edit an API test with a DataTable scenario, you need to add the variable names from the DataTable and the values from the scenario manually.
For example, consider the following DataTable:
Scenario | first_name | last_name | |
---|---|---|---|
User A | John | Smith | [email protected] |
User B | Jane | Doe | [email protected] |
If you wanted to train with the variables in this DataTable, you would need to take the following steps for each variable (first_name
, last_name
, email
):
- In the API Test Editor, click on the Add row button in the Variables section
- Add the variable name. Make sure that the variable names match the DataTable variable names exactly.
- Add a default scenario value. To train with the values from the
User A
scenario, you would add these variables to the API Test Editor:

Adding DataTable values to the API Test Editor
While editing, the API Test Editor uses the default values that you added manually. When you run the API test locally or in the cloud, the default values are overridden by values from an associated DataTable. Learn more about working with data-driven variables in API tests here.
Updated about 2 months ago