Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check 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 desk6 min

How to Run Applitools Visual Tests in GitHub Actions

Run your existing Applitools visual tests in GitHub Actions, keep the API key in a GitHub secret, tie results to commits, and review visual diffs safely.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run Applitools Eyes from your project’s existing test framework in a GitHub Actions workflow, provide the API key through a GitHub Actions secret, and associate each run with its commit. GitHub can report the check, but a person should review visual differences in Applitools Test Manager before accepting a changed baseline.

How the workflow fits together

Applitools Eyes is used alongside a test framework rather than as a single universal GitHub Actions command. Your tests contain the Eyes calls; GitHub Actions checks out the repository, prepares the runtime and dependencies, and runs the project’s normal visual-test command. The exact test setup and command depend on the SDK and framework in your project.

  1. Configure visual tests in the framework and SDK your project already uses.
  2. Save the Applitools API key as a repository secret.
  3. Run the tests on the GitHub events you want to check, commonly pushes and pull requests.
  4. Give the Applitools batch a stable identity tied to the commit.
  5. Review the GitHub check and inspect any visual differences in Test Manager.

Set up the Applitools key securely

In the GitHub repository, open Settings → Secrets and variables → Actions, choose New repository secret, and create a secret named APPLITOOLS_API_KEY containing the key from your Applitools account. Reference it in the workflow as an environment variable; do not paste the key into committed YAML, test code, or logs.

Repository secrets are available to workflows in that repository, but do not assume they will be exposed to workflows triggered from forks. Keep secrets unavailable to untrusted pull-request code, and use your repository’s permitted event and approval model for contributions from forks.

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

Add a GitHub Actions workflow

The following is a workflow skeleton for an existing Cypress project. It assumes the repository has a committed package-lock.json, a script named test:visual that runs the project’s Cypress tests with Eyes enabled, and a setup in those tests that reads APPLITOOLS_API_KEY. Replace the script name, Node version, and runtime setup to match your project. This is not an Applitools-specific universal test command.

name: Visual tests

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  visual-tests:
    runs-on: ubuntu-latest
    steps:
      - name: Check out code
        uses: actions/checkout@v4

      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm

      - name: Install dependencies
        run: npm ci

      - name: Run visual tests
        run: npm run test:visual
        env:
          APPLITOOLS_API_KEY: ${{ secrets.APPLITOOLS_API_KEY }}

Pinning GitHub Actions to a reviewed version or immutable commit is a repository security decision; update dependencies and action references under your normal maintenance policy. The example uses GitHub’s checkout and Node setup actions, not a dedicated Applitools-maintained action.

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

Configure a batch identity for each revision

A stable batch identity helps connect Eyes results to the code revision that produced them. One documented approach is to use the Git commit SHA as the Applitools Batch ID. The workflow can expose the SHA to the test process:

env:
  APPLITOOLS_BATCH_ID: ${{ github.sha }}

However, the environment variable name alone does not guarantee that every Eyes SDK reads it. Configure the batch ID using the API or configuration supported by the SDK and version in your project, and pass the commit SHA into that configuration. Keep the ID consistent among tests that are intended to belong to the same batch. The Cypress and Selenium Java examples use framework-specific test calls; consult the current documentation for your chosen SDK rather than copying an unrelated framework’s syntax.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
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.

Choose triggers and execution strategy

Pushes and pull requests

A push workflow checks changes after they reach a branch; a pull-request workflow lets reviewers see results before merging. The sample watches pushes and pull requests targeting main. Adjust the branch filters and event types to match your branch policy, and ensure the workflow receives credentials only in trusted contexts.

Hosted runner or self-managed runner

The example uses a GitHub-hosted Ubuntu runner. If your tests require a particular browser, operating system, network route, or installed dependency, use a compatible runner and explicitly prepare those prerequisites. The exact runner setup is project-specific; the cited examples do not establish one runner configuration as universally preferable.

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.

Serial run or matrix shards

Start with a single job if the suite is small enough. A matrix can split a larger suite across jobs, but parallel jobs on the same commit may share a batch. Applitools’ 2026 Storybook guidance warns that automated batch closing can cause one shard to close a batch before the others finish. For that parallel setup, check Test Manager at Admin → Teams → Integrations → GitHub → Manage repositories and disable automated batch closing as appropriate for the account. Confirm the setting with your team before scaling; it is not a general requirement for a single serial job.

Review results rather than auto-accepting changes

Use the GitHub check to see whether the workflow completed and open the linked Applitools results to examine detected differences. A visual difference is a review item, not automatically a defect or an acceptable change. Compare it with the intended code change, then accept a new baseline only when the rendered UI change is expected. Reject or investigate unexpected changes before merging.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Common problems and fixes

  • Missing or invalid API key: Check that the repository secret is named exactly APPLITOOLS_API_KEY, that the workflow maps it into the test step’s environment, and that the run’s event context is allowed to access secrets.
  • Tests run but Eyes does not receive the key: Confirm the test process inherits the environment variable and that the SDK configuration uses it as expected. Do not print the value to diagnose it.
  • Workflow cannot find the test command: Confirm the script exists in the project manifest and that the workflow installs the dependencies using the repository’s package manager and lockfile.
  • Results are difficult to associate with a commit: Pass the commit SHA into the batch-ID configuration supported by the selected SDK. Verify that the batch identity is actually applied; setting an arbitrary environment variable is not sufficient unless that SDK reads it.
  • Parallel results appear incomplete or close early: Check whether multiple shards are writing to the same batch and review the account’s GitHub integration batch-closing setting before changing the matrix.
  • An old workflow action example fails or looks risky: A 2021 tutorial used the third-party action colbyfayock/applitools-eyes-action@main. Do not treat it as a current official Applitools action or copy its inputs without checking present maintenance, supported inputs, and version pinning. Running the project’s own test command is the more adaptable pattern.
  • GitHub is green but the page still has a visual mismatch: Open the Eyes results and review the differences. The workflow status does not replace a human decision about whether a new baseline is correct.

Performance, reliability, and cost considerations

Runtime depends on the existing test suite, browser setup, and whether tests run serially or in shards; the available examples do not establish a general execution-time benchmark. Begin with the framework and runner the project already uses, then measure the actual workflow before adding parallelism. Sharding can reduce elapsed time but introduces batch coordination that must be configured correctly.

Keep dependencies and action versions under review, and make failures diagnosable without exposing credentials. No pricing or usage allowance is established here, so check the terms for the Applitools account and plan you use rather than assuming a fixed cost.

Or skip the browser setup

If the task is to capture a page image or PDF rather than run baseline-based visual assertions, ScreenshotNeo offers a one-request screenshot API and an MCP server for AI agents. Its API removes cookie banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, timeouts, failed loads, and cache hits are not billed. Applitools visual tests and a screenshot API solve different problems: use Eyes to detect and review changes against visual baselines, and use a screenshot capture when you need an image or PDF.

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 parameters. ScreenshotNeo has an MCP server with take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients. The free plan includes 1,000 screenshots per month without a card; paid plans start at $5 for 3,000 screenshots. Sign up for ScreenshotNeo’s free plan.

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

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.

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. Shenzhen desk3 min
    HONOR Expands Beyond Smartphones With Humanoid Robot RevealHONOR said it unveiled its first humanoid robot at MWC 2026 and named shopping assistance, workplace inspections, and supportive companionship as intended uses. Later Robotics D1 claims and a reported…
  2. Cupertino desk5 min
    Apple Unveils AirPods Max 2: The Upgrade That Should Have Happened Years AgoAirPods Max 2 adds H2-powered audio features and Apple claims up to 1.5× more effective ANC, but its design, Smart Case, and 20-hour battery rating are unchanged. Wired lossless audio…
  3. Cupertino desk4 min
    Apple’s OLED Touch MacBooks Are Coming—but the Dynamic Island Is the Real GambleApple has not announced an OLED touchscreen MacBook, but reports point to high-end models arriving in late 2026 or early 2027. The reported Mac Dynamic Island could be useful, but…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

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.