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:
| Mode | Pass/fail impact | Diff display | When to use |
|---|---|---|---|
full | Pixel diffs count toward mismatch | Red diff pixels | Strict comparison (default) |
ignore | Excluded from mismatch score | Greyed out on diff image | Widgets, ads, out-of-scope areas |
dynamic | Excluded from mismatch score | Stays visible (red) for audit | Timestamps, carousels, live counters |
layout_only | Content pixels excluded; only width/height deltas fail | Greyed out; layout badge if size changes | Feeds 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
| Field | Description |
|---|---|
| Selector | CSS selector targeting the region |
| Mode | Comparison mode (see table above) — click the mode badge to cycle through modes |
| Label | Optional semantic label for the rule |
| Reason | Optional note explaining the rule |
| Propagate | Apply 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 capturesLayout-only for a news feed
Selector: .news-feed
Mode: layout_only
Layout tolerance: 5px
Reason: Content updates frequently but layout should remain stableStrict comparison for branding
Selector: .brand-header
Mode: full
Reason: Logo and brand elements must never changeWho 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.