Skip to main content

Parameters & Test Datasets Overiew

Quick start guide to understand how parameters and datasets help in test management

Shriti Grover avatar
Written by Shriti Grover
Updated over 2 weeks ago
Feature availability: Elite & Enterprise plans

What are Parameters?

A parameter is a named placeholder that you can embed inside test‑case steps or expected results by wrapping the name in double curly braces — for example `{{email}}`. During execution, TestCollab swaps the placeholder with real data coming from a linked dataset.

What is a Test Dataset?

A test dataset is a table that lists one or more parameters as columns and holds one or more rows of data for them. When a dataset is linked to a test case, the same test logic can be re‑run for every row, capturing separate results for each iteration.

Why use test datasets?

  • Design data‑driven test cases without copying and pasting steps

  • Avoid rewriting tests for every data combination

  • Re‑run the same test with different parameter values at any time

  • Record distinct results for each data variation

⏱️ Quick‑start in four steps

1. Create a dataset-

Select a project, then click Settings ▸ Test Datasets and click Add Test Dataset. Give the dataset a unique name. For example- “Login Credentials”

2. Add parameters-

Add one or more Parameter Names (they must be unique within the dataset) , For example- username, password. Now enter sample data in the table cells.

3. Reference parameters in a test case-

Edit your Login test, replace hard-coded strings with
Enter {{username}}Enter {{password}} . TestCollab will display matching datasets below the steps area.

4. Select Dataset

Choose Select to link an existing dataset or Use as template to clone the dataset structure into a brand‑new one. Save the test case — you now have a data‑driven test.

5. Run the test

Create a Test Plan and start a new run. TestCollab automatically iterates through each dataset row.

Did this answer your question?