Recipes

Run a filtered set of flows with custom values.

A Run Recipe allows you to define a reusable set of filters and value overwrites for test execution.

You can find and manage recipes in Settings → Run Recipes. From there, you can create a new recipe, edit an existing one or click the Run button to immediately execute it with the configured filters and values.

When creating a new recipe, start by giving it a title. Then configure the following sections:

Flow Filters

Control which flows are included in the run:

Filter Type	Description
Include Tags	The flow must contain all of the selected tags.
Exclude Tags	The flow must not contain any of the selected tags.

Test Case Filters

Control which individual test cases are included within the matching flows:

Filter Type	Description
Include Tags	The test must contain all of the selected tags.
Exclude Tags	The test must not contain any of the selected tags.

Value Overwrites

Override default values used during test execution by providing key-value pairs. These values replace any matching values defined in the Value Store.

Example

{
  "BASE_URL": "https://staging.example.com",
  "USERNAME": "testuser123",
  "COUNTRY": "UK",
  "FEATURE_FLAG_CHECKOUT_V2": true
}

This is useful for running the same tests across different environments, user accounts, regions, or feature flag configurations — all without modifying the test logic.

Iterating Over Values

You can configure a recipe to iterate over a list of values, allowing the same set of tests to run multiple times — once for each item in the array.

To do this, provide an array of objects in the Value Overwrites section. Each object represents a separate run with its own values. During execution, the values are injected into the tests just like standard overwrites.

Setting a PrimaryValue

When iterating over multiple values, it can be helpful to set a primaryValue inside each object. This will then be displayed on your test results to highlight which data set was being run.

Example

[
  {
    "primaryValue": "United Kingdom",
    "COUNTRY": "UK",
    "USERNAME": "user_uk",
    "BASE_URL": "https://uk.example.com",
    "CURRENCY": "GBP"
  },
  {
    "primaryValue": "Germany",
    "COUNTRY": "DE",
    "USERNAME": "user_de",
    "BASE_URL": "https://de.example.com",
    "CURRENCY": "EUR"
  },
  {
    "primaryValue": "France",
    "COUNTRY": "FR",
    "USERNAME": "user_fr",
    "BASE_URL": "https://fr.example.com",
    "CURRENCY": "EUR"
  }
]

In this example, the recipe will run the selected flows three times:

1. Once using values for the UK environment

2. Once using values for the German environment

3. Once using values for the French environment