TL;DR

  • Environment variable overrides for staging/dev testing.
  • New tips for Visual Regression Analysis (VRA) in Layout review mode.
  • Improved CLI exit codes for signal-aborted runs.

Key Changes in Percy v1.32.0 (Released 2026-06-17)

This minor update from Percy (v1.31.9 to v1.32.0) by BrowserStack focuses on enhancing configurability, user guidance, and CLI reliability for test automation.

Enhancements:

  • Environment Variable Overrides: Percy now supports environment variable overrides for webdriver-utils, specifically designed for testing on staging and Percy-dev environments. This feature (feat(webdriver-utils): env-var overrides for staging/percy-dev testing) simplifies configuration management across different deployment stages, allowing QA engineers to adapt Percy’s behavior without modifying core test scripts.
  • VRA Tips in Layout Review Mode: A new feature (feat(core): tip about VRA when a build uses Layout review mode) introduces helpful tips regarding Visual Regression Analysis (VRA) when a build utilizes Layout review mode. This guides users towards more effective visual testing strategies, aligning with best practices discussed in articles like Percy, Applitools, BackstopJS: Visual Regression Testing Tools.

Bug Fixes:

  • CLI Exit Code for Aborted Runs: A crucial fix (fix(cli-command): exit non-zero on any signal-aborted run) ensures that the Percy CLI command exits with a non-zero status code if a run is aborted by a signal. This is vital for CI/CD pipelines, allowing them to accurately detect and react to failed or interrupted visual tests.

Maintenance:

  • PERCY_GZIP Asset Cap Bypass: A fix (fix(core): allow PERCY_GZIP to bypass raw-size cap on asset discovery) addresses an issue where PERCY_GZIP could bypass the raw-size cap on asset discovery, ensuring consistent asset handling.

Impact for QA Teams

QA teams gain more control over environment-specific configurations and receive better guidance for visual regression analysis. The improved CLI exit codes enhance CI/CD reliability, ensuring automated pipelines accurately reflect test outcomes and prevent silent failures. These updates streamline visual testing workflows and improve overall test automation efficiency.

Official Changelog: Percy CLI v1.32.0 Full Changelog