Most WordPress problems after an update are not white screens of death. They are smaller than that: a button that moved below the fold, a menu that no longer opens on mobile, a product grid that suddenly shows one column instead of three. The site still loads, so uptime monitoring says everything is fine. But the page is broken for the people who use it.
Visual regression testing is designed to catch exactly these problems.
What is visual regression testing?
Visual regression testing means taking screenshots of a page before a change and after a change, and comparing them pixel by pixel. If the difference is larger than you expect, something probably changed that should not have.
For WordPress sites, the change is usually an update: a plugin, a theme or WordPress core.
What it catches
- Layout changes caused by a page builder or theme update
- Missing or broken images and icons
- Menus, sliders or forms that no longer render
- Error notices printed on the page
- Differences that only appear on mobile
What it does not replace is testing actual behaviour, such as whether a form really sends an email. It is a fast, reliable way to see whether pages still look the way they should.
Desktop and mobile
Always compare both. Many themes and page builders use different layouts for small screens, and an update can break one without affecting the other. A page that looks perfect on a laptop can be unusable on a phone.
Which pages to check
You do not need to screenshot every page of every site. Focus on the pages that matter:
- the homepage
- the pages in the main menu
- shop, product and checkout pages for WooCommerce sites
- the login page
- a handful of extra pages that are important to this specific client
Setting a threshold
Some differences are normal. Dates change, sliders rotate, and a cookie banner can appear on one screenshot and not the other. That is why visual comparisons use a threshold: a percentage of the page that is allowed to change before the result counts as a problem.
Choose a threshold using repeated screenshots of the unchanged page, then check whether meaningful layout changes are still detected. A percentage alone does not tell you whether a change matters: a small broken button can be more important than a large rotating banner. Mask genuinely dynamic regions selectively, and keep important controls visible to the comparison.
Where it fits in your update routine
Visual regression testing is most useful when you combine it with a staging copy:
- Take screenshots of the key pages.
- Run the updates on a copy of the site.
- Take the same screenshots on the copy and compare.
- Review the visual result alongside the other configured checks before updating the live site. A result below the threshold is not proof that every visitor flow works.
This way a broken layout is found on the copy, not by your client on the live site.
Doing it by hand versus automating it
You can do this manually with a browser and some patience, and there are general-purpose tools for developers. For an agency with many client sites, the real challenge is doing it every time, for every site, without it eating your week.
Visual checks on every update, for every client site.
Every update is checked, and the risky ones are tested on a copy of the site first: Verploy compares the pages included in the run on desktop and mobile. Review the recorded test scope and verdict; eligible low-risk updates may use a direct route when enabled, while risky updates can be tested on a copy first. Start free, no credit card.