Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk4 min

How to Automate Visual Testing with Percy

Add Percy’s SDK to Playwright or Cypress, capture stable UI states, run your suite through percy exec, and review visual diffs before updating the baseline.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To automate visual testing with Percy, add its SDK to your existing test suite, capture deliberate UI states with snapshot calls, set the Percy project token in the run environment, and execute the tests through percy exec. Percy builds visual comparisons from those snapshots; review each change and approve the baseline only when the new appearance is intentional.

How Percy visual testing fits into an existing test suite

Percy adds visual snapshots to functional tests rather than replacing those tests. The integration has two parts: framework-specific SDK calls at the states you want to inspect, and the Percy CLI process around the test command. The token lets that process associate submitted snapshots with your Percy project. See Percy’s integrations page to check current support for your framework, application type, CI/CD provider, and review workflow.

A useful snapshot captures a meaningful user-facing state—for example, a page after navigation or a form after a successful submission—not an arbitrary moment while the interface is still changing. Give snapshots stable, descriptive names so reviewers can recognize corresponding states across builds.

Add Percy to Playwright

Install the CLI and SDK

npm install --save-dev @percy/cli @percy/playwright

Percy’s Playwright SDK repository documents the package and snapshot workflow: percy-playwright.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Ishihara Test Chart Books, for Color Deficiency
  • Grafco Ishihara Test Chart Book
  • Package Info: Each
  • Includes four special plates for tests to determine the kind and degree of defect in color vision.
  • Image may not reflect actual product sold. Please read description carefully.
  • GHF1254

Capture a stable state

Import the snapshot function and call it after the test has reached the intended state. For example:

import { test, expect } from '@playwright/test';
import { percySnapshot } from '@percy/playwright';

test('home page renders', async ({ page }) => {
  await page.goto('https://example.com');
  await expect(page.getByRole('heading', { name: 'Example Domain' })).toBeVisible();
  await percySnapshot(page, 'Home page');
});

Replace the example URL and assertion with the route and functional checks for your application. The assertion makes the capture point explicit: Percy should receive the state your test intends to validate.

Set the token and run the suite

Create or select the Percy project for the application, then provide its token through the environment. For a local shell, set PERCY_TOKEN without committing the value to source control. In CI, store it as a secret/environment variable and expose it to the step that runs Percy.

Rank #2
Ishihara Colour Vision Test Book for Color Deficiency 24 Plates with User Manual
  • individuals with color vision defect should see a different figure from individuals with normal color vision.
  • Makes use of the peculiarity that in red-green blindness, blue and yellow appear remarkably bright compared with red and green
  • Diagnostic plates: intended to determine the type of color vision defect
  • Ishihara Test Chart Books for Color Deficiency 24 Plates with usar manual
export PERCY_TOKEN=your_project_token
npx percy exec -- npx playwright test

The command wraps the normal Playwright run so Percy can receive the SDK snapshots and finalize a build. Without the Percy process and a valid token available to the run, the SDK examples do not upload snapshots as a Percy build.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add Percy to Cypress

Install and import the integration

npm install --save-dev @percy/cli @percy/cypress

Import @percy/cypress in the Cypress support file, then add cy.percySnapshot() calls at the points where a visual check belongs. Percy’s Cypress SDK repository and its Cypress visual testing guide document this integration.

Capture and run a visual build

For example, after visiting a page and confirming it has loaded, add a named snapshot:

Rank #3
Ishihara Test Chart Books for Color Deficiency 38 Plates with User Manual and One Eye Occluder by KASHSURG
  • Vanishing design: Only people with good color vision can see the sign. If you are colorblind you won’t see anything.
  • Transformation design: Color blind people will see a different sign than people with no color vision handicap.
  • Hidden digit design: Only colorblind people are able to spot the sign. If you have perfect color vision, you won’t be able to see it.
  • Classification design: This is used to differentiate between red- and green-blind persons. The vanishing design is used on either side of the plate, one side for deutan defects an the other for protans.
cy.visit('https://example.com');
cy.get('h1').should('be.visible');
cy.percySnapshot('Home page');

Set PERCY_TOKEN in the local or CI environment, then wrap the Cypress command:

export PERCY_TOKEN=your_project_token
npx percy exec -- cypress run

As with Playwright, adapt the example route and readiness check to your application and keep the token out of the repository.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Review diffs and maintain the baseline

The first run needs an approved reference baseline. Later builds compare their snapshots against that reference and surface visual differences for review. A diff is evidence of a change, not automatically a defect: decide whether the new rendering is intended before approving it.

Rank #4
NCE Visual Study Guide & Activity Book by Lindsay Braman - Spiral-Bound Test Prep for National Counselor Exam & CPCE - Illustrated Interactive Studying to Engage Creative, Neurodiverse, & ADHD Minds.
  • This illustrated & interactive study guide for the National Counselor Exam (NCE) uses images, colors, mnemonics, and humor to engage brains in effective study.
  • 150+ page activity book including coloring book pages, fill in the blank sheets, and tear-out flashcards with content addressing all domains covered in the NCE + CPCE counselor exams.
  • Full size 8.5x11, spiral-bound for lie-flat studying.
  • Printed on premium, 80lb textured paper you can color and highlight with no bleed.
  • Drawn by (human!) hand. Printed and bound in the USA.
  • If the change is intentional, approve it so the baseline reflects the expected interface.
  • If the change is unexpected, fix the application or test setup and run the suite again rather than accepting the altered baseline.
  • Keep snapshot names consistent so reviewers can identify the page or state being compared.

Percy describes CI/CD and pull/merge request workflows, and its integrations page also mentions Slack notifications and webhooks. Choose the route that fits the team’s existing review process.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot common setup failures

No Percy build or uploaded snapshots

Check that the test command is wrapped in percy exec, that the SDK snapshot call runs, and that PERCY_TOKEN is available to the same process. Confirm the token belongs to the intended Percy project.

Snapshots show an incomplete or transient page

Move the snapshot call until after navigation, interaction, and relevant asynchronous rendering have finished. Add a functional readiness check before capturing instead of relying on a call placed immediately after a page visit.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Reviewers cannot tell snapshots apart

Replace generic or changing names with stable labels that describe the route and state, such as Checkout — payment form. Use the same name for the corresponding state on later runs.

Package or framework instructions do not match your project

Percy’s SDK and integration details can change. Check the current package and framework support on the integrations page and the relevant Playwright or Cypress repository before changing a working test setup.

Or skip the browser setup:

If your need is to request screenshots through an API rather than add visual diffs to an automated test suite, ScreenshotNeo offers a one-request capture. For example, this cURL call saves a WebP screenshot of Stripe:

Quick Recap

Bestseller No. 1
Ishihara Test Chart Books, for Color Deficiency
Ishihara Test Chart Books, for Color Deficiency
Grafco Ishihara Test Chart Book; Package Info: Each; Image may not reflect actual product sold. Please read description carefully.
$19.00
Bestseller No. 2
Ishihara Colour Vision Test Book for Color Deficiency 24 Plates with User Manual
Ishihara Colour Vision Test Book for Color Deficiency 24 Plates with User Manual
Diagnostic plates: intended to determine the type of color vision defect; Ishihara Test Chart Books for Color Deficiency 24 Plates with usar manual
$30.00
Bestseller No. 4
NCE Visual Study Guide & Activity Book by Lindsay Braman - Spiral-Bound Test Prep for National Counselor Exam & CPCE - Illustrated Interactive Studying to Engage Creative, Neurodiverse, & ADHD Minds.
NCE Visual Study Guide & Activity Book by Lindsay Braman - Spiral-Bound Test Prep for National Counselor Exam & CPCE - Illustrated Interactive Studying to Engage Creative, Neurodiverse, & ADHD Minds.
Full size 8.5x11, spiral-bound for lie-flat studying.; Printed on premium, 80lb textured paper you can color and highlight with no bleed.
$48.99
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

See the ScreenshotNeo API documentation for request options and setup. Cookie banners, popups, and chat widgets are removed before capture; bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots, and the free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000. Sign up for free.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.