Step 17 - Visual regression

Drupal 9 site migration project delivery blueprint


The details on this page represents the goal, activities, deliverables and resources for conducting a visual regression as part of a site migration project.

The visual regression is step 17 of a 24 step project delivery process Salsa has designed for migrating (or upgrading) sites from a legacy or proprietary CMS to Drupal 9.

An overview of the entire process can be found here: Drupal 9 site migration project delivery blueprint.


4B: Validate


Validation of user interface across the site. Drupal 9 site looks and feels like the source CMS site.


  1. Visual regression (ideally automated) of all pages against devices, browsers, orientations, etc...

  2. Issues identified and remedidated

  3. Sign off and approvals


  1. Signed off visually accepted sign

  2. List of known visual regression issues

Resources and templates*

  1. Visual regression test tooling tips and tricks

  2. Visual regression test script samples

* to be publically available by Q1 2021 to align with the GovCMS D9 roadmap.  Reach out if you’d like a draft version beforehand.

Is your GovCMS site ready for Drupal 9?

Ensure your GovCMS website will remain current and secure with our Drupal 9 readiness assessment. Know your upgrade pathways and options, potential costs and timeframes. Find out more about Salsa’s D9 readiness assessment

Register for readiness assessment