Scenarios
Scenarios
Configure what VisualQ captures, compares, and how it handles dynamic content.
A scenario is the fundamental unit of visual testing in VisualQ. Each scenario defines:
- What to capture (URL and optional CSS selectors)
- How to capture it (viewports, delay, click actions)
- How to compare it (thresholds, content rules, comparison rules)
Scenario fields overview
| Field | Required | Default | Description |
|---|---|---|---|
| Label | Yes | — | Human-readable name for the scenario |
| URL | Yes | — | Full URL to capture |
| Viewports | Yes | Phone, Tablet, Desktop | Which screen sizes to test |
| Selectors | No | main | CSS selector to scope the capture |
| Delay | No | 1500ms | Wait time before capturing |
| Threshold | No | 0.1% | Mismatch tolerance percentage |
| Content rules | No | — | Normalize dynamic content |
| Click selectors | No | — | Elements to click before capture |
| Comparison rules | No | — | Per-region comparison behavior |
| Browsers | No | Chromium | Which browsers to use |
Organizing scenarios
Scenarios can be organized into groups for better navigation. You can drag and drop scenarios to reorder them and create logical groupings. See Groups and ordering.