When screenshots are missing from an Argos CI build, first determine which stage failed: the test may not have captured an Argos snapshot, the reporter may not have uploaded it, authentication or file selection may have blocked the upload, or Argos may have received a screenshot that does not match a baseline. Check those stages in order rather than changing configuration at random. The exact cause depends on your framework, workflow, and logs.
Start by locating the break in the pipeline
Separate the problem into three observable states: whether the screenshot file exists in the CI workspace, whether an Argos build received an upload, and whether the uploaded screenshot matches a baseline. A missing file points toward test execution or capture; a file without an Argos upload points toward reporter, authentication, or file-selection configuration; an uploaded image absent from the expected comparison may be an unmatched snapshot or a missing baseline.
As an Amazon Associate I earn from qualifying purchases.
- Inspect the CI test command, its exit status, filters, and test output.
- Check whether the expected screenshot file exists in the job workspace, and note its exact path and extension.
- Open the Argos build for the same commit and branch. Check whether a build was created and whether it shows uploaded screenshots, an upload error, or an unmatched image.
Confirm the test captured an Argos screenshot
For Playwright using Argos’s documented helper, confirm the test calls argosScreenshot(page, "name"). The Playwright quickstart says the helper writes screenshots to ./screenshots by default. Check the configured output directory if your project overrides it. See the Argos Playwright Quickstart for its framework-specific setup.
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 problemsDo not confuse Playwright’s failure screenshot option with an Argos visual snapshot. In the quickstart, screenshot: "only-on-failure" and trace: "on-first-retry" are debugging settings; the example separately configures the Argos reporter and calls the Argos screenshot helper. A failure-only Playwright artifact does not by itself establish that an Argos snapshot was captured.
#1 Best Overall
- Please note, this device does not support E-SIM; This 4G model is compatible with all GSM networks worldwide outside of the U.S. In the US, ONLY compatible with T-Mobile and their MVNO's (Metro and Standup). It will NOT work with other CDMA carriers, and it is also not compatible with their MVNO (Visible, Xfinity Mobile, US Mobile, Cricket Wireless, etc).
- Compatibility with certain third-party devices and accessibility accessories, including some hearing aids, may vary depending on manufacturer support, Bluetooth protocols, software compatibility, and regional firmware limitations. For additional hearing aid compatibility information, please refer to Samsung’s official support documentation.
- Camera: 50 MP, f/1.8, (wide), 1/2.76", 0.64µm, AF | 50 MP, f/1.8, (wide), 1/2.76", 0.64µm, AF | 2 MP, f/2.4, (macro). Battery: 5000 mAh, non-removable | A power adapter is NOT included.
Check the Argos reporter and CI condition
In the Playwright example, the reporter list includes @argos-ci/playwright/reporter, with options created using createArgosReporterOptions({ uploadToArgos: !!process.env.CI }). Verify the reporter is present alongside any existing reporters and that the process running tests actually receives CI. A project-specific override may also disable upload.
That configuration is a Playwright example, not a universal setting for every Argos integration. Argos’s JavaScript SDK repository lists packages for Playwright, Cypress, Puppeteer, WebdriverIO, Storybook, Vitest, CLI, and core; check the configuration for the package and version your framework uses: Argos JavaScript SDKs. The quickstart describes automatic upload when the reporter detects a CI environment, but do not assume every runner or custom environment is detected identically.
Verify authentication in the job that runs the tests
The Playwright quickstart uses ARGOS_TOKEN, set to the project token shown in Argos under Settings → General → Token. Confirm it is available to the exact CI job and step that runs the tests. Check your repository’s rules for forked pull requests or protected secrets if the variable is missing; secret availability depends on the CI provider and repository settings.
Recommended Free Tools
Rank #2
- YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
- LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
- MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
- NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
- BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.
The quickstart also documents GitHub Actions authentication using OIDC or tokenless authentication as alternatives to storing a secret. Follow Argos’s current instructions for that method rather than copying an assumed configuration: Playwright Quickstart and GitHub Actions example. Never print a token into public logs; record whether it is present without exposing its value.
Match the uploader’s root and file glob to CI output
If screenshots exist in the workspace but do not appear in Argos, compare the actual working directory, output path, extension, and glob with the uploader configuration. The @argos-ci/core example uses root: "./screenshots", files: ["**/*.png"], and defaults to process.env.ARGOS_TOKEN. These are example values: adjust them to the files your job actually produces.
import { upload } from "@argos-ci/core";
await upload({
root: "./screenshots",
files: ["**/*.png"],
});Check whether your screenshots are nested below the root and whether they are PNGs rather than JPEGs or another format. A correct-looking glob can still select nothing if the process starts in a different directory than expected. The core SDK’s example and token behavior are documented at @argos-ci/core — Argos Node.js SDK.
Rank #3
- Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Tracfone plan required, activating is easy, just 3 steps.
- DISPLAY: Immersive viewing on a 6.7-inch super-bright 120Hz display with powerful stereo speakers and Bass Boost for cinematic entertainment.
- CAMERA SYSTEM: Advanced 50MP Quad Pixel camera captures sharp, detailed photos and videos in any lighting condition
- PERFORMANCE: Lightning-fast 5G connectivity paired with a powerful processor and RAM Boost for smooth multitasking.
- BATTERY LIFE: Long-lasting 5000mAh battery with TurboPower charging technology delivers hours of power in minutes.
If you manage uploads directly, avoid treating the old standalone argos-cli repository as the default current route: that repository is marked deprecated and points to the JavaScript SDKs. Start with the current integration or SDK documentation for your framework.
Distinguish an unmatched screenshot from a missing upload
An uploaded screenshot can appear as added rather than as a visual diff if Argos cannot find a same-name baseline. That means the image reached Argos, but there is no matching earlier image to compare. The fallback-baseline guide documents ordered baseName values: Argos tries the screenshot’s own name first, then a fallback name.
For example, a new variant can use its own name and then the established snapshot name as fallback. Once the variant has a baseline, its own name can match first. For SDK-free metadata uploads, the guide uses transient.baseName; names include extensions and, for Playwright projects, can include a project prefix such as chromium/home.png. Inspect the mapping on the build page when the intended fallback is not being used.
Rank #4
- YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
- LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
- MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
- NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
- BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.
Also check that a build has completed on the default branch. Argos requires a default-branch build before pull request builds have a baseline; without one, PR builds are marked orphan. This is a baseline issue, not proof that the test failed to capture a screenshot.
Use a focused troubleshooting checklist
- No file in CI: Check that the intended test ran, was not filtered out, completed the capture call, and wrote to the expected location.
- File exists, but no Argos build or upload: Check reporter registration, the CI upload condition, authentication availability, and upload logs.
- Build exists, but expected files are absent: Compare the upload root, working directory, extensions, and glob with the actual workspace contents.
- Image is present but has no matched diff: Check its snapshot name, project prefix, fallback names, and whether the default branch has established a baseline.
Before changing settings, preserve the evidence that distinguishes those cases. For a useful support or debugging report, record the commit and branch, CI provider and job, test framework and SDK version, test command and exit status, whether files exist and their paths and extensions, reporter and upload settings, token presence without its value, upload logs, and the Argos build link and status.
Or skip the browser setup
For a separate website-screenshot task, ScreenshotNeo offers a one-request API and an MCP server. It is not an Argos CI reporter or a fix for a broken Argos upload. A basic capture looks like this:
Best Value
- Charger NOT Included, 6.7" Super AMOLED FHD+, 90Hz Refresh Rate, 385 ppi, 800 nits (HBM), 1080x2340px, 5000mAh Battery
- 128GB, 4GB RAM, microSDXC, Exynos 1330 (5nm), Octa-Core, Mali-G68 MP2 or Mali-G57 MC2 GPU
- Rear Camera: 50MP, f/1.8 (wide) + 5MP, f/2.2 (ultrawide) + 2MP, f/2.4 (macro), LED flash, panorama, HDR; Front Camera: 13MP, f/2.0, Android 14, up to 6 major Android upgrades, One UI 6.1
- 3G: HSDPA 850/900/1700(AWS)/1900/2100; 4G LTE: 1/2/3/4/5/7/12/13/14/20/25/26/28/29/30/38/39/40/41/48/66/71, 5G: 2/5/25/41/66/71/77/78 SA/NSA/Sub6/mmWave - Nano-SIM + eSIM
- US Model – Global Connectivity – Compatible with Most GSM Carriers like T-Mobile, AT&T, MetroPCS, etc. Will Also work with CDMA Carriers Such as Verizon, Straight Talk.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo API documentation for request options. ScreenshotNeo removes cookie banners, newsletter popups, and chat widgets 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 per month with no card; paid plans start at $5 for 3,000. Learn about ScreenshotNeo or sign up for 1,000 free screenshots a month, no card required.
Frequently Asked Questions
Does Playwright’s `screenshot: “only-on-failure”` setting upload a screenshot to Argos?
No. The Argos Playwright example uses a separate Argos reporter and `argosScreenshot` call for its visual snapshots.
What information should I include when asking for help with a missing Argos screenshot?
Share the CI job and commit, framework and SDK version, test command and result, file paths and extensions, reporter and upload configuration, token availability without the token itself, upload logs, and Argos build status.
PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Crashes, 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 minuteQuick Recap
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.
