Add your first page
Create a page to define what VisualQ should capture and compare.
A page (VRT scenario) tells VisualQ what to capture: which URL, at what viewports, and with what rules. Think of it as a test case for visual regression.
Create a page
Navigate to Pages
From your project sidebar, open Pages, or use Add your first page on the overview checklist.
Click New page
Click "+ New page". The page form will open.
Configure the scenario
At minimum, fill in:
- Label: a human-readable name (e.g., "Homepage", "Pricing page")
- URL: the full URL to capture (e.g.,
https://example.com/pricing). When an environment is selected, the origin portion of this URL is automatically replaced by the environment's base URL at test time. - Viewports: toggle which viewports to test — Desktop (1920×1080), Tablet (768×1024), Phone (375×667)
Save the page
Click Save. Your page appears in the list and VisualQ automatically starts capturing reference screenshots — no separate "Sync refs" step required.
Optional settings
You can also configure:
- Selectors — focus the capture on a specific element (e.g.,
main,#content) - Delay — wait time in milliseconds before capture (default: 1500ms), useful for animations
- Threshold — mismatch tolerance as a percentage (default: 0.1%)
- Content rules — normalize dynamic content like dates or ads
- Click selectors — click elements before capture (e.g., close cookie banners)
- Comparison rules — fine-grained control over how regions are compared
These are covered in detail in the Scenarios section.
What happens next
Reference capture runs in the background after save. When it completes, you can run your first full quality audit → from the project overview.