For the complete documentation index, see llms.txt. This page is also available as Markdown.

Add visual checks

Catch visual and layout changes with Vision Test Steps in the Flow Builder.

Vision Test Steps watch what is on screen. Use them when a Check on text or attributes is not enough, such as branding, charts, or layout drift.

Use the Flow Builder for this walkthrough.

Choose the right Vision step

Test Step
Use it to

Compare the page or an Element to a saved visual control

Confirm an Element has not moved

Check a written expectation in plain language

Start with Element Snapshot for regression on a fixed design. Use AI Vision when you can describe the outcome more clearly than you can pin a pixel baseline.

Add an Element Snapshot

1

Reach the screen you care about

Build the journey with Open, Touch, and other steps until the page shows the UI you want to protect.

2

Add Element Snapshot

From the Vision family, add Element Snapshot.

  1. Set Mode to Element for one control, or Page for the full view.

  2. Choose the Element when Mode is Element.

  3. Set Acceptable change allowed if a small difference should still pass.

3

Run once to create the control

The first successful Run stores the current look as the control. Later Runs compare against that control.

4

Read the result

Open the step in the Run result. Review Control and Actual, and the comparison views between them, to see what changed.

5

Update the control when the change is intentional

When the new design is correct, use Update Snapshot Control on that step in the result so future Runs use the new baseline.

Check position

Add Element Position when layout drift matters more than pixels inside the control. Choose the Element, run once to establish the control, then compare on later Runs.

Describe an expectation with AI Vision

Add AI Vision when you can write what should be true.

  1. Set Mode to Page or Element.

  2. Choose the Element when Mode is Element.

  3. Write an Expectation in plain language, optionally with Values.

Pro tip: Prefer Mode Element for AI Vision and Element Snapshot when the check is about one component. A tighter target keeps failures easier to read.

Last updated