Hey! These docs are for version 1, which is no longer officially supported. Click here for the latest version, 2-web!

Automatic visual diff matching

Percy automatically matches and groups snapshots that have the same visual change, saving you time and effort while reviewing builds.


Criteria for matching diffs

For diffs to be matched, the following criteria must be met:

  • All diffs must have the same geometry, including size but irrespective of page coordinates.
  • Both the baseline snapshots and new snapshots must have the exact same underlying pixels across diffs.
  • Only snapshot comparisons that have the same diff geometry and underlying pixels for each enabled width and browser will be matched.


When matching diffs are detected, they are grouped together at the top of your snapshot list. All matching changes can be approved with a single click, or you can expand the groupings and approve individual snapshots.

If you have questions about matching diffs, please feel free to contact support.