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

BrowserStack visual regression testing is provided by Percy. Percy captures a page or mobile-app screen, compares it with an approved baseline, and shows visual differences for a person to review. A diff is evidence of a rendering change—not proof of a bug. Your team must decide whether the change is an intended design update or a regression.

This guide explains the baseline workflow, web and mobile coverage, integration choices, usage planning, review practices, and troubleshooting using BrowserStack’s current documentation.

How Percy visual regression testing works

Percy turns visual checks into a repeating baseline cycle:

  1. Create a Percy project and capture an initial build. Because there is no previous approved version, the first build establishes the baseline.
  2. Capture later builds. Percy compares each snapshot with the current baseline and marks changed regions.
  3. Review every difference. Approve intentional changes to promote them to the baseline. Leave real regressions unapproved, fix the implementation, and run the test again.

The comparison is screenshot-based. Functional tests can verify that a button works; Percy verifies that the rendered pixels remain within the visual expectation. BrowserStack describes this workflow in its visual-testing basics documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.

What a snapshot and build mean

A build is a test-run grouping. A displayed snapshot can contain several browser or responsive-width renderings, but billing counts the individual screenshots used for those renderings. This distinction is important when forecasting usage.

Why human review remains necessary

Text changes, new content, font loading, animation timing, and responsive reflow can all create a diff. Percy highlights the change; a reviewer determines whether it is acceptable. Approving without checking can turn a defect into the new baseline.

Choose web Percy or App Percy

Need Product Coverage
Websites and web applications Percy web Browser and responsive-width renderings
Native mobile application screens App Percy Devices and operating-system versions

For web projects, Percy can compare selected browser and width combinations. Different browser engines may produce legitimate rendering differences, so browser-specific comparisons can expose regressions that a single browser misses. For native applications, App Percy compares screens across device and OS combinations; BrowserStack recommends using the BrowserStack SDK as a simplified integration path, while a Percy SDK is also available. See the App Percy visual-testing overview.

Select an integration path

Automation and SDK integration

Use a Percy SDK or BrowserStack SDK when you already have automated tests and a CI/CD pipeline. The test navigates to the state you want to protect, captures a Percy snapshot, and lets the build report return to your source-control review process. This approach gives you repeatable setup, test data, authentication handling, and a natural place to fail or review a build.

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

BrowserStack documents multiple SDK approaches rather than one universal command because the setup depends on your test framework and language. Start with the Percy integration options page, select your framework, create a Percy project, and add the project token as a CI secret instead of committing it to the repository.

No-script or CLI onboarding

The no-script path is useful for a static site, a quick proof of concept, or an ad-hoc set of URLs. It lets you evaluate the review experience before modifying a test suite. It has less control than an integrated test over login state, dynamic data, and precise test sequencing, so move to an SDK integration when the check becomes part of release quality.

Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

Combine functional and visual execution

Teams already using BrowserStack Automate can decide whether BrowserStack should execute the cross-browser test and Percy should manage the visual comparison, or whether Percy-managed browser choices are sufficient. The correct choice depends on where your functional tests run, which browsers you must certify, and how you want failures represented in CI.

Design a useful coverage matrix

Do not select every possible permutation by default. Each browser, width, or device adds screenshot usage and increases the number of differences a reviewer may need to assess.

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

Web matrix

  • Choose browsers that your users and support policy require.
  • Choose representative responsive widths, including breakpoints where layout changes.
  • Use full-page captures when content below the fold matters; verify that lazy-loaded images are included.
  • Prefer Percy’s Recommended match level as a starting point, then adjust for known page noise and animation.

For example, two pages across two browsers and three widths produce 12 individual screenshots, according to BrowserStack’s billing example. A page that displays as one grouped snapshot can therefore consume several screenshot units.

Mobile matrix

  • Start with the devices that represent your supported user base and highest-risk layouts.
  • Add OS versions when platform rendering differences affect the UI.
  • Expand coverage for navigation, checkout, onboarding, and other screens where a small visual defect has a high user cost.

App Percy explains that one snapshot across three devices counts as three usage units. Treat the matrix as a risk decision, not a race to maximize device count.

Control visual noise before approving changes

Unstable captures create review fatigue. Make the page deterministic before taking a snapshot:

  • Wait for fonts, images, and API data to finish loading.
  • Disable or freeze animations, carousels, clocks, random IDs, and rotating promotions.
  • Use stable test data and a fixed authentication state.
  • Capture the same scroll position and viewport each run.
  • Separate intentional content updates from layout assertions when the content changes frequently.

BrowserStack recommends full-page screenshots and its Recommended match level, but those are vendor recommendations rather than a guarantee for every application. A long, highly dynamic page may require narrower captures or targeted regions to keep signal high. Guidance is available in the recommended guidelines.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

Review and baseline-management workflow

  1. Open the Percy build associated with the pull request or commit.
  2. Filter to changed snapshots and inspect each highlighted region at a useful zoom.
  3. Check whether the difference is caused by the intended code change, test data, browser behavior, or capture instability.
  4. Approve only intentional changes. Approval promotes the reviewed snapshot to the baseline.
  5. For a regression, reject or leave the snapshot unapproved, fix the code, and rerun the build.
  6. Record why a change was approved when the reason is not obvious from the pull request.

BrowserStack describes both Git-oriented and Visual Git baseline-management preferences. Choose the model your team can review consistently, and protect baseline changes with the same access controls used for production-facing code.

Plans, allowances, and usage planning

The following figures are vendor-published allowances in BrowserStack’s current documentation and can change; verify them before purchasing.

Product Free monthly allowance Users/projects Overage
Percy web 5,000 screenshots Unlimited users and projects Plan-specific usage beyond the included amount
App Percy 1,000 screenshots Unlimited users and projects Plan-specific usage beyond the included amount

See Percy plans and billing and App Percy plans and billing for current plan quantities and overage treatment. Estimate consumption as:

pages or screens × browsers or devices × widths × builds.

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

Then add reruns caused by flaky tests and branch builds. A smaller, risk-based matrix is often more sustainable than running every permutation on every commit; schedule broader coverage for release candidates if that matches your risk tolerance.

Common problems and fixes

Every snapshot is different

Likely causes: animations, timestamps, random data, late fonts, or asynchronous requests. Fix: freeze dynamic values, wait for a stable selector or network idle in your test, and use deterministic fixtures.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

Images are missing below the fold

Likely cause: lazy loading has not been triggered before capture. Fix: use a full-page capture strategy that loads lazy images, or scroll through the page in setup before taking the snapshot.

A browser shows differences that others do not

Likely causes: engine-specific font metrics, CSS support, or rendering behavior. Fix: confirm that the difference is reproducible, inspect computed styles and loaded fonts, then decide whether the browser-specific result is an actual supported-browser defect.

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

The first build has no changes to review

This is expected: the first build establishes the baseline. Run a second build after the page or app state is stable.

Usage is higher than expected

Count individual browser, width, and device renderings rather than the number of grouped snapshots shown in the UI. Review branch builds and reruns, then reduce redundant permutations.

Reviewers approve changes too quickly

Require a pull-request owner or designated visual reviewer to inspect each changed region. A diff is a review signal, not an automatic defect classification.

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

Or skip the browser setup

If you only need a clean screenshot or PDF from a URL, ScreenshotNeo provides a one-request website screenshot API and MCP server. It accepts cookie and consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; each step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers identify the page verdict and billing result. Its MCP tools—take_screenshot, get_page_info, and capture_pdf—work with Claude, Cursor, and other MCP clients.

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

Use the API documentation at https://screenshotneo.com/docs/ for all options.

Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.

cURL

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Python

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)

Node.js

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

ScreenshotNeo includes full-page and element capture, dark mode, device presets, retina scale, PDF controls, custom CSS and JavaScript, clicks, waits, request blocking, headers, cookies, user agents, authorization, timezone, geolocation, transparent backgrounds, resizing, TTL caching, signed links, async webhooks, bulk capture for up to 100 URLs per call, usage reporting, and an OpenAPI specification. Every feature is on every plan. The free plan includes 1,000 shots per month with no card; paid plans start at $5 for 3,000 shots. Create a free ScreenshotNeo account.

When Percy is the better fit

Choose Percy when visual checks must live inside an existing automated web or mobile test process, when reviewers need baseline approval tied to source-control changes, or when you need a deliberate browser, width, device, and OS matrix. Choose a simple screenshot API when the requirement is producing clean reference images or PDFs rather than maintaining an approved regression baseline.

Frequently Asked Questions

Does Percy replace functional testing?

No. Percy compares rendered visuals; it does not prove that interactions, data validation, or business logic work. Pair it with functional and accessibility tests.

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

Can I approve only part of a changed snapshot?

Review the changed regions in the Percy interface and use your team’s approval policy; baseline promotion should represent an intentional, reviewed state rather than an unexamined pixel change.

How often should the browser or device matrix change?

Revisit it when your support policy, analytics, major UI architecture, or user geography changes. Keep the matrix tied to risk and supported environments.

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.