Manage visual testing baselines as reviewed reference screenshots, not files CI should refresh automatically. Capture pages under repeatable conditions, compare pull-request output with an explicit baseline, inspect every meaningful diff, and accept intended changes through a reviewed workflow. A changed screenshot is evidence of a rendering change—not, by itself, proof of a defect.
What a visual testing baseline is
A baseline is an accepted rendering that later test runs use as a reference. On the first Playwright visual test run, when no matching reference exists, Playwright writes a screenshot for review. Once accepted and committed, subsequent runs compare their screenshots with that reference and report differences.
The baseline therefore encodes a decision about what the interface should look like under particular capture conditions. Treat its creation and updates as changes to the test’s expectations. Playwright recommends committing generated snapshots to version control and reviewing changes to them (Playwright visual comparisons).
Choose where baselines live and how they are approved
For a repository-managed workflow, screenshot files live with the code and are changed through ordinary version control. For a hosted workflow, a service associates captures with builds or branches and provides a review interface. Neither model removes the need to choose the correct comparison target or review changes.
#1 Best Overall
- 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.
| Decision | Repository-managed snapshots (Playwright example) | Hosted workflows (Percy and Chromatic examples) |
|---|---|---|
| Baseline storage | Snapshot image files in the repository; commit and review them with the test changes. | The service associates snapshots with builds and branches and stores accepted baselines. |
| How changes become the new reference | Run the update command, inspect generated images, and commit the approved files. | Review changes in the service and accept or deny them; acceptance advances a baseline where documented. |
| Approval scope | Repository review and merge policy determine what snapshot changes are accepted. | Percy Git approves or rejects a whole build; Percy Visual Git allows snapshot-level approval. Chromatic reviews snapshot changes. |
| Baseline selection | Your checkout and CI configuration determine which reference files are used. | Percy Git traces a base build through commit history; Visual Git uses latest approved snapshots on each branch. Chromatic UI Tests use a branch baseline, while UI Review compares a branch with its merge base. |
| Capture environment | Your team controls it and should keep baseline creation and comparison conditions aligned. | Rendering and review are handled through the service workflow; verify the chosen service’s capture behavior and settings. |
| Merge gate | Test results and repository review rules can block a merge. | A vendor status check can surface review state to a pull request and can be required before merge. |
Choose repository-managed files when you want the expected images and their history directly in source control. Choose a hosted review flow when its build, branch, and approval controls fit your team’s process. For approval granularity, Percy’s two Git strategies differ materially: build-wide approval versus approval of individual snapshots. See Percy Git integration.
Build a repeatable capture environment
Differences are useful only when they are not dominated by environmental noise. Playwright warns that host operating system, browser version and settings, hardware, power source, and headless mode can affect screenshot rendering. Its guidance is to run comparisons in the same environment that generated the baseline (Playwright visual comparisons).
- Fix the runtime. Pin the browser version and run baseline creation and CI comparison in the same operating-system image and headless configuration. Avoid generating references on a developer laptop and comparing them in a materially different CI environment.
- Fix the viewport and display scale. Use consistent viewport dimensions and device scale settings so layout wrapping and pixel density are comparable.
- Use stable data and states. Control test data and application state. Avoid letting timestamps, rotating ads, random content, or other changing elements vary without reason between runs.
- Control animation and volatile elements narrowly. Playwright supports a screenshot stylesheet through
stylePath, which can hide or neutralize specific dynamic elements. Filter only content that is genuinely irrelevant to the check; broad suppression can conceal real regressions. - Choose representative coverage. Capture the pages, components, and important states whose visual behavior matters, rather than treating one screenshot as a proxy for the entire application.
Keep environment changes deliberate. If you upgrade the browser or change the rendering environment, expect that screenshots may move; review those changes as a baseline transition rather than silently treating them as application regressions.
Rank #2
- 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.
Create and commit the initial baseline
For Playwright, write a visual assertion with a screenshot expectation, then run the relevant test with no existing reference. The first run creates a snapshot. Review the generated image for correctness and commit it with the test code so the reference is available to later CI runs.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallimport { test, expect } from '@playwright/test';
test('home page visual reference', async ({ page }) => {
await page.goto('http://127.0.0.1:3000');
await expect(page).toHaveScreenshot('home.png');
});npx playwright testThe test must run against the application in the state and environment you intend to preserve. Inspect the generated snapshot directory before committing; the first image establishes what future comparisons regard as accepted. Playwright recommends committing the snapshot directory and reviewing its changes (Playwright visual comparisons).
Hosted services can establish references from an initial build as well. Chromatic says later builds compare against existing baselines, and that baselines update only when changes are accepted by you or your team (Chromatic: Branches, baselines, and git history). Review the first build with the same care as a later update: it defines the point of comparison.
Rank #3
- 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.
Run comparisons in CI against an explicit base
Run visual checks on pull requests or other changes where the result can be tied to a commit. Before enabling a merge gate, make clear which reference CI will compare against. A green or red result is difficult to interpret if the baseline source is implicit.
- Repository snapshots: ensure CI checks out the intended reference files for the tested commit or target branch, and that snapshot updates are not being generated as an automatic side effect of ordinary test runs.
- Percy Git: its Git strategy traces a base build through commit history. Visual Git instead selects the latest approved snapshots for each branch; choose the strategy that matches your branch and acceptance model (Percy Git integration).
- Chromatic: UI Tests use a branch baseline; UI Review compares a branch against its merge base. These comparisons answer different questions, so select the one aligned with the review you intend to perform (Chromatic: Branches, baselines, and git history).
Once the comparison target is clear, use CI status as a merge gate if your team requires visual review before integration. Chromatic documents accepting changes to advance baselines and denying changes to fail the build; its status check can be required for merge readiness (Chromatic CI integration). Decide who can accept or deny changes and what happens when a review is still pending.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Scan for outdated or missing drivers - takes under a minute3Repair Windows errors before they cause bigger problemsReview diffs and advance baselines deliberately
A diff means the rendered result changed. It may reflect an intended redesign, a regression, or a capture-condition change. Compare the before and after images and inspect the affected page or state before deciding.
Rank #4
- 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
- Identify the changed snapshots and the affected UI state.
- Determine whether the difference was intended and whether it is limited to the expected area.
- Accept intentional changes through the project’s review mechanism; reject or fix unexpected changes.
- Update the reference only after that decision, and keep the code change and baseline change in the same review context where practical.
For Playwright, update local references explicitly with npx playwright test --update-snapshots. Then inspect every changed image and commit the approved snapshot changes. Do not run this as an unattended routine CI refresh: doing so can normalize unreviewed output as the new expectation.
npx playwright test --update-snapshotsPlaywright also provides maxDiffPixels and screenshot styling options for handling comparison sensitivity and volatile content. Set tolerances intentionally, document why they are appropriate, and validate that they do not hide meaningful changes (Playwright visual comparisons).
Keep branch baselines and history aligned
Hosted workflows may preserve different accepted references on different branches. Chromatic documents that a feature branch can retain an older baseline after a change has been accepted elsewhere; when the branch later incorporates that change, it may show already-approved work as a new difference. Regularly merge or rebase the current mainline into long-lived feature branches to keep their comparison context current.
Recommended Free Tools
Best Value
- 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.
Chromatic also documents how it chooses among possible ancestor snapshots when branches merge: by default it selects the most recently accepted baseline, and it provides alternatives for preferring merged baselines. Make sure contributors understand which reference is selected and how accepted, denied, or unreviewed changes affect future comparisons (Chromatic: Branches, baselines, and git history).
Or skip the browser setup
If you need a captured page as an artifact rather than a version-controlled test baseline, ScreenshotNeo provides a website screenshot API and MCP server. One GET request returns an image or PDF; this example saves a WebP capture. See the ScreenshotNeo API documentation for request options.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpScreenshotNeo accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each of those steps can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and the response reports the page verdict and billing status in headers. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for AI agents and MCP clients.
The free plan includes 1,000 shots per month without a card; paid plans start at $5 for 3,000 shots. Sign up for ScreenshotNeo’s free plan.
Free tools Windows power users keep installed
One-click scans. No signup required.
Quick Recap
Troubleshoot common baseline problems
- Many snapshots change after a CI move or browser upgrade: compare the baseline-generation and test environments, including OS, browser, settings, hardware, and headless mode. Align them or intentionally review the resulting baseline change.
- A test fails on changing content: stabilize the data or isolate the genuinely volatile element with a narrowly scoped screenshot stylesheet. Do not suppress a large region simply to make the diff pass.
- A feature branch reports changes that were already accepted on main: update the feature branch from the current mainline so its branch-specific baseline context is synchronized.
- A PR compares against an unexpected image: verify the configured base build or branch strategy and confirm which snapshot set CI checked out or selected.
- A visual change passes without review: check whether snapshot update mode is enabled in CI or whether a hosted service’s status check is absent from required merge checks. Keep baseline promotion explicit.
- A tolerance setting makes diffs disappear: inspect the changed pixels and reduce or remove the tolerance if it masks a meaningful interface change; use a project-specific reason for any non-default threshold.
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.
