VisualQ

Comparison rules

Fine-grained control over how specific page regions are compared.

While content rules normalize content before capture, comparison rules control how regions are compared after capture. They let you apply different comparison strategies to different parts of the page.

Comparison modes

Each comparison rule specifies a mode that determines how the selected region is handled:

ModePass/fail impactDiff displayWhen to use
fullPixel diffs count toward mismatchRed diff pixelsStrict comparison (default)
ignoreExcluded from mismatch scoreGreyed out on diff imageWidgets, ads, out-of-scope areas
dynamicExcluded from mismatch scoreStays visible (red) for auditTimestamps, carousels, live counters
layout_onlyContent pixels excluded; only width/height deltas failGreyed out; layout badge if size changesFeeds and grids where content changes but layout must stay stable

Creating rules from the Regions view

In the diff viewer Regions mode (6), click Ignore, Dynamic, or Layout only on a page section. The rule targets the section's CSS selector with propagate: true so child elements inherit the mode. A semantic label (the section title, e.g. "LETTRES QUÉBÉCOISES") is saved with the rule for easier identification.

Rule fields

FieldDescription
SelectorCSS selector targeting the region
ModeComparison mode (see table above) — click the mode badge to cycle through modes
LabelOptional semantic label for the rule
ReasonOptional note explaining the rule
PropagateApply the rule to child elements as well (shown as +children badge)

The following fields are available on the data model but not currently editable from the UI: match strategy (exact or contains), layout tolerance, and per-region threshold.

Examples

Ignore a live chat widget

Selector: #chat-widget
Mode: ignore
Reason: Chat widget state varies between captures

Layout-only for a news feed

Selector: .news-feed
Mode: layout_only
Layout tolerance: 5px
Reason: Content updates frequently but layout should remain stable

Strict comparison for branding

Selector: .brand-header
Mode: full
Reason: Logo and brand elements must never change

Who creates comparison rules?

Comparison rules can be created by:

  • You — manually from the scenario edit page
  • AI Coach — suggested automatically based on page analysis Hobby plan

Rules created by the Coach are tagged with createdBy: 'coach' so you can tell them apart.

On this page