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

By default, VisualQ captures the main element of the page. You can change the capture scope to a different CSS selector.

main
#hero-section
.product-grid

Remove selectors

Elements you want to hide before capture. Useful for removing cookie banners, chat widgets, or other overlays that interfere with consistent screenshots.

.cookie-banner
#intercom-container
.floating-cta

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). Pro and Custom 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.

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.