AI visual change summaries

Understand how Percy summarizes visual changes using AI and how to review them efficiently.

Percy’s AI Visual Changes feature automatically analyzes your build screenshots and summarizes key visual updates. Using advanced machine learning, it identifies layout shifts, text and color changes, and asset modifications, helping you quickly understand the impact of each change and speed up your review process.

Benefits

AI visual summaries help you:

• Understand diffs quickly and speed up your visual review process.
• Spot regressions faster without reviewing all snapshots.
• Prioritize reviewing the most relevant or high-impact changes.
• See related visual changes grouped together in the summary for faster understanding.

Prerequisites

Before using AI visual change summaries:

• Set up App percy and ensure baseline screenshots exist.
• Enable the Visual Review Agent AI toggle for the build; summaries appear only when this toggle is on.

AI summary

Percy generates an AI-driven summary at the top of the build review page, above the snapshot thumbnails. This summary provides a quick, high-level view of the visual updates detected in the build without opening individual diffs. By default, the following applies:

• The summary appears collapsed with a callout indicating that an AI summary is available.
• Each summary item includes a number in brackets, which indicates how many snapshots are affected by that specific change.

Group by visual changes

To group snapshots based on AI-detected visual changes, use the Group by visual changes option. Open the AI summary and click Show More to access this grouping control.

Expand it to view grouped changes and access the Group by visual changes option.

You can open the grouped view either from the expanded AI summary using Group by visual changes or from the left navigation under the Group snapshots by section.

When you enable grouping, Percy hides the summary to:

• Maximize review space and reorganizes snapshots under AI-generated headers such as “Your rewards section added.”
• Adds an Unchanged snapshots group at the end.

To exit the grouped view, clear the grouping to return to the standard snapshot list.

Things to know

Review these constraints and states before relying on the summary:

• Percy does not generate a summary if a build has more than 50 comparisons with differences.
• A summary appears only when AI diff is available for all comparisons with differences in the build. If the AI diff is not available, refer to the Visual Review Agent documentation for possible reasons.
• The summary and its groups remain tied to the diffs detected during the build run. Any actions taken afterward such as adding or ignoring regions, applying AI prompts, or switching A/B variants do not update or regenerate the summary.

For more information, check Visual Review Agent documentation page.

Related topics

• Group by test case name
• Group with matching diffs