WebdriverIO Visual Service

Visit Website

Introduction

The WebdriverIO visual-testing project contains the modules for running visual tests with WebdriverIO: @wdio/visual-service, the service that integrates visual testing; @wdio/image-comparison-core, the comparison engine; @wdio/ocr-service for OCR-based testing; and @wdio/visual-reporter, an HTML report generator for visual results, according to its README.

After adding the service to wdio.conf.js, tests can save and check screenshots of the visible screen, individual elements, full pages and tabbable elements, with options to ignore regions, hide elements and set mismatch thresholds. Baselines are stored next to the spec file by default. It works for desktop browsers, mobile web and native apps through Appium.

Release @wdio/visual-service 11.1.0 shipped in November 2026.

In the quality loop it adds visual checks to existing WebdriverIO end-to-end suites.

The source code is at webdriverio/visual-testing on GitHub under the MIT licence, with about 166 stars; the most recent commit was on 11 November 2026.

Features

1. Screen, element and full-page checks: Several capture modes.
2. Ignore and hide: Stabilise comparisons.
3. Native app support: Visual checks via Appium.
4. OCR service: Text-based interactions and checks.
5. HTML reporter: Review visual results.

Pros

1. Free and integrated: No external service needed.
2. Free to use: Open source under the MIT licence, so the core tool costs nothing to use.
3. Actively maintained: The repository had commits as recent as 11 November 2026.

Cons

1. WebdriverIO only: Not for other frameworks.
2. Local baselines: No hosted review workflow.

Usage and Links (Example)

npm install --save-dev @wdio/visual-service

// in a spec
await expect(browser).toMatchScreenSnapshot('homepage')

Resources:

• WebdriverIO Visual Service website
• GitHub repository

Pricing

WebdriverIO Visual Service is free and open source under the MIT licence.

Recommended for?

1. WebdriverIO users adding visual checks.
2. Not a fit for teams wanting hosted review.

Conclusion

The WebdriverIO Visual Service is the natural, free way to add visual testing to WebdriverIO suites.

On CheckOps, WebdriverIO Visual Service is filed under the End-to-end & functional stage. Related tools listed here include WebDriverIO, Percy, Applitools, jest-image-snapshot, BackstopJS and Argos. Before choosing, compare them on licence, supported languages and platforms, hosting model, and how well each fits your existing CI pipeline. Facts on this page were checked against the official website, documentation and repository on 11 November 2026; statements the vendor makes about its own product are marked as vendor claims.