Flow Builder

Build and rearrange Flows on a visual canvas with the Flow Builder.

The Flow Builder is the visual editor for a Flow. You place Test Steps on a canvas, connect them, and grow the design into full coverage.

After Getting Started, journey guides use the Flow Builder as the default way to build. The Scenario editor shares the same Test Steps. Switching tabs shows the same Flow another way.

Flow Builder canvas with a Checkout smoke path

What you can do here

• Drag Test Steps from the step library onto the canvas, and filter the library when you search

• Connect steps so each Test Case path is clear

• Open a step to set Elements, Values, and other fields

• Add Flow Branches when one Flow should cover more than one path

• Gate a branch with Condition when a path should run only for a device, language, timezone, or Value

• Drop in Step Groups for shared login or setup

• Select several steps, align them, duplicate them, or turn them into a Step Group

• Run or preview the Flow from the toolbar, then open Results

Open the Flow Builder

1

Open a Flow

Open a Flow from Flows, or create one.

2

Select the Flow tab

Select the Flow tab.

New Flows open in the Scenario editor first. Use the Flow tab when you want the canvas, branches, or a clearer view of a growing Flow. See Create and run your first Flow.

Build on the canvas

1. Find a Test Step in the step library. Type in the search box to filter by name or family.

2. Drag the step onto the canvas below the step it should follow, so the connector joins them.

3. Open the step and set its fields.

4. Keep adding steps until the path matches the journey you want to prove.

Pro tip: Hold Shift and drag to select several Test Steps at once. Then duplicate them, align them, or create a Step Group from the selection.

Useful canvas actions

Action	How
Undo / redo	Toolbar controls, or Cmd/Ctrl+Z and Cmd/Ctrl+Shift+Z
Copy / paste	Cmd/Ctrl+C and Cmd/Ctrl+V
Duplicate	Cmd/Ctrl+D, or Duplicate Step(s) on the context menu
Align	Select two or more steps, then align left, right, top, or bottom from the context menu
Delete	Backspace or Delete. Neighbouring steps reconnect when a middle step is removed
Save	Changes autosave. Cmd/Ctrl+S also saves

Branches and Conditions

A Flow with more than one path uses Flow Branches. Design the shared steps once, then split into paths for smoke vs regression, mobile vs desktop, or staging vs production tags.

Use Condition early on a branch when that path should run only for a matching Runner, device, language, timezone, or Run Value. Use Tag Test when a schedule, Recipe, or CI/CD call should pick the path by tag.

For a full walkthrough, see Build smoke and regression coverage.

Run from the Flow Builder

Use Run Flow on the toolbar to start a Run while you edit. Overflow controls also let you Run Tests or Preview Tests when you want a narrower check. Open Results from the same place when the Run finishes. See Understand your results.

When to prefer the Flow Builder

Prefer the Flow Builder when	Prefer the Scenario editor when
You need Flow Branches or a multi-path design	You want a single path as plain-language sentences
You are rearranging or extending a larger Flow	You are starting a simple Flow for the first time
You want the step library and canvas layout	You are happiest editing step text in a list
You need Step Groups, align, or multi-select canvas tools	You are editing Values and Element names in sentence form

Related

• Scenario editor

• DoesQA AI

• Create and run your first Flow

• DoesQA concepts

• Reuse steps with Step Groups

• Build smoke and regression coverage

• Condition

• Terminology