Modules and parameters

Reusable modules#

A module packages a sequence of test steps into a single reusable component you can reference from multiple test cases, instead of recreating the same workflow every time.

Create a module#

1. 01

   Open Modules

   Go to Modules within the project and select Create Module.

2. 02

   Add module details

   Name the module, set its Status (new modules start as Draft), and describe its purpose.

3. 03

   Describe the workflow

   Under Action Steps, describe the reusable workflow in natural language.

4. 04

   Choose a folder and generate

   Select a destination folder, then click Generate. The module opens in its own workspace for review.

Module workspace#

• Context — prerequisite setup steps that run automatically every time the module executes, before the reusable steps begin.
• Module Steps — the reusable workflow itself; select a step to inspect its generated code, screenshots, and status.
• Dependencies — every test case currently using the module, useful for judging the impact of a change before you make it.
• Code Editor — the generated Playwright for the module, for direct review or edits.

During execution, Lucius AI always runs a module's Context steps first, then its Module Steps — so any reusable flow starts from the same known state.

Parameters#

A parameter is a reusable key-value pair — a username, URL, or other test data — that you define once and reference across multiple test cases instead of hardcoding it everywhere.

Create a parameter#

1. 01

   Open Parameters

   Go to Parameters and select Create Parameter.

2. 02

   Set a key and value

   Provide a unique Key to identify the parameter and the Value it should resolve to.

3. 03

   Create it

   Review the details and select Create Parameter. It's immediately available across the project.

Managing parameters#

Every parameter appears in the Parameters list with its Key, Value, and Visibility. Use Edit to update a parameter, or Delete to permanently remove it from the project — it's no longer available for future test executions.

{{parameter_key}}

During execution, Lucius AI resolves the referenced key and substitutes its value automatically — updating a parameter updates every test case that references it.

Running with parameters#

Test cases and suites can be run with parameters explicitly, using the Run with parameters option. Choose which values to use for that run, and Lucius AI substitutes them wherever the parameter is referenced.