Create a scenario

Creating a scenario

From your project's Scenarios tab, click "+ New scenario" to open the scenario form.

Required fields

• Label: a descriptive name that identifies this scenario in results and reports. Examples: "Homepage", "Checkout flow", "User profile".
• URL: the full URL to capture. Must be publicly accessible (or accessible from the VisualQ worker).

Optional fields

Selector

CSS selector stored on the scenario for reference and Coach context. Captures are always full-page — the worker screenshots the entire document, not just the selected element.

main
#hero-section
.product-grid

Remove selectors

CSS selectors for elements to remove from the DOM before capture (not merely hidden). Useful for cookie banners, chat widgets, or other overlays that interfere with consistent screenshots.

The worker also supports a separate hideSelectors field (visibility hidden) in the API, but the dashboard form exposes remove selectors only.

Delay

Time in milliseconds to wait after page load before capturing. Default is 1500ms.

Increase this value if your page has:

• Animations that need to complete
• Lazy-loaded images
• Client-side rendering that takes time

Browsers

By default, scenarios run on Chromium (always enabled). Team, Business, and Enterprise plans can also enable Firefox and WebKit (Safari).

Require same dimensions

When enabled, the test fails if the test screenshot dimensions don't match the baseline. This catches unexpected layout shifts that change the total page height.

Form modes

The scenario editor supports two modes:

• Form — the default visual editor with all fields
• Raw JSON — edit the scenario definition as JSON directly, useful for bulk editing or copy-pasting configurations

Editing a scenario

Click on any scenario in the list to open its detail page. Make your changes and click Save.

Viewing scenario results

The scenario detail page shows the scenario card and configuration on the left, and a results matrix on the right. Results are grouped by execution, then split by viewport and browser. Each row summarizes the available audit pillars:

• Quality: average score for the audits that produced a value
• VRT: visual regression result
• A11Y: accessibility result
• Perf: performance result
• SEO: SEO result
• Security: security result
• Tracking: datalayer/tracking result

Click any populated audit cell to open the detailed viewer for that execution.

FRT recordings

Functional regression scenarios can appear in the same scenario list as URL-based visual scenarios. When a scenario has a recorded video, its card displays the video poster and lets you play the recording inline with the browser's native fullscreen controls.

Deleting a scenario

From the scenario detail page, scroll down and use the delete option. This removes the scenario and all its associated baselines and test results.