Product updates / Guide

Show UI changes with matched before-and-after screens

Match everything that is not part of the update before comparing two interfaces. Stable data, scale and state let the viewer see the released difference instead of mistaking unrelated changes for product improvements.

By AnimroUpdated 3 min readAI-assisted · independently agent-reviewed

Who this is for: Product teams preparing clear software update communication.

What to prepare

  • Old and new screens tied to identified releases.
  • The same illustrative record and account role.
  • Capture dimensions, zoom, theme and selected filters.

Define exactly what the comparison should prove

Write a narrow claim before selecting screenshots. “The owner filter moved into the toolbar” needs location evidence. “Finding an owner takes fewer actions” additionally needs a verified action sequence. The same pair of attractive screens cannot support both claims automatically.

Choose a comparison state that isolates the update. If a panel is open in the new screen and closed in the old one, decide whether opening the panel is the change or merely a capture inconsistency. Label intentional differences instead of leaving the viewer to guess.

  • Identity controls: account role, workspace and example record.
  • Layout controls: viewport, zoom, theme and scroll position.
  • State controls: selection, filters, open panels and loaded data.
  • Release controls: the version and capture date for each screen.

Worked example: move an owner filter

In this fictional update, the owner filter moves from a side panel to the list toolbar. Use the same illustrative request list, filtered to Awaiting review, in both versions. Keep the same row count and visible sample names. The before screen shows the side-panel route; the after screen shows the toolbar control.

Comparison log: record R-042 remains in row two; role remains Reviewer; zoom remains fixed; the owner choice remains Example owner. Intended difference: control location. Unintended difference: the new capture uses a shorter sidebar and exposes an extra row. Recapture or crop both to equivalent context before approving the pair.

  • Opening label: “Owner filter: previous location.”
  • Transition: hold a shared list anchor while changing the surrounding control view.
  • Closing label: “Owner filter: now in the toolbar.”
  • Proof limit: location has changed; no measured speed improvement is established.

Choose a treatment that preserves context

A side-by-side view helps inspect layout differences, but it reduces each screen's available size. An alternating matched crop may be clearer for a small control, provided persistent labels prevent confusion about which version is visible. Use a wide view first when the crop would otherwise hide the location.

Avoid morphing every old UI element into the new layout. Such animation can imply a real in-product transition or make unverified intermediate states look factual. A labeled editorial cut is often sufficient.

Audit the pair in its final composition

Inspect labels and control text at the size they will actually appear. A high-resolution source does not guarantee a readable split-screen composition. Keep comparison labels visible long enough to identify the versions.

Finally compare the prepared asset with the source captures. Record any masking or sample-data replacement. A cleaner scene should not remove an essential warning, permission restriction or empty-state message that changes the meaning of the update.

Review checklist

  • The pair supports one stated comparison claim.
  • Record identity and sample values match across versions.
  • Unrelated viewport and state differences are corrected.
  • Old and new labels remain unambiguous.
  • No visual treatment implies unverified speed or transition behavior.
Explore product updates ↗