Understand your results
Learn to read test results and use the Diff Viewer.
After a test run completes, VisualQ presents detailed results showing exactly what changed and where.
Run status
Each test run has an overall status:
| Status | Meaning |
|---|---|
| Passed | All scenarios match their baselines within the configured thresholds |
| Failed | One or more scenarios have visual differences exceeding their thresholds |
| Error | Something went wrong during capture or comparison |
The Diff Viewer
The Diff Viewer is the core tool for reviewing visual changes. It offers six comparison modes:
- Side by side (
1) — reference and test images displayed next to each other - Slider (
2) — drag a slider to reveal differences between the two images - Overlay (
3) — test image overlaid on the reference with adjustable opacity - Toggle (
4) — click or press a key to flip between reference and test - Diff highlight (
5) — pixel differences highlighted in color on a neutral background - Regions (
6) — changed areas outlined with bounding boxes
Press keys 1–6 to quickly switch between viewer modes. Press R to toggle between normalized and raw images.
Filtering results
In the Diff Viewer you can filter scenarios by:
- Status: All, Passed, or Failed
- Browser: All or a specific browser (Chromium, Firefox, WebKit)
Approving changes
When a visual change is intentional (e.g., you redesigned a component), you can approve it. This updates the baseline so future tests compare against the new appearance.
- Click the Approve button on a specific scenario in the Diff Viewer
- Or use Approve All from the Tests page to approve every failing scenario in a run
See Approve changes for more details.
AI Analysis
On Starter plans and above, VisualQ can automatically analyze visual differences using AI:
- Smart Diff classifies the severity of each change Starter plan
- Coach AI explains what changed and suggests whether to approve or investigate Pro plan
What's next?
You've completed the getting started guide! Here are suggested next steps:
- Configure scenarios in detail — content rules, thresholds, click selectors
- Set up CI/CD — automate testing on every deploy
- Connect integrations — GitHub PR checks, Slack notifications