If a Chromatic build is stuck in progress, first check how long it has been running. Chromatic says it automatically cancels a build that remains stuck for two hours. If it is still in progress after that, contact Chromatic support at support@chromatic.com or use the in-app chat. Before escalating, compare the Chromatic build page with the CI run that launched it; that helps you see which step is still active without guessing at a cause.
What to do first
- Check the elapsed time. If the build has been stuck for less than two hours, Chromatic’s published guidance is to allow time for its automatic cancellation. The FAQ does not document a separate immediate manual-cancel procedure.
- Open the Chromatic build page and the CI run. Compare their statuses and timestamps. The CI step may still be running, or the CI workflow may have completed while the Chromatic page still shows an in-progress build.
- Inspect the CI step logs. Look for whether the Chromatic command or action completed, failed, or is still executing. Save the workflow run URL and relevant log output for support if you need to escalate.
- Compare your workflow with the official setup. Verify that the repository is checked out, dependencies are installed, and the Chromatic project token is available to the workflow as a secret. Storybook’s publishing example uses a full-history checkout (`fetch-depth: 0`) and the Chromatic action; these are configuration details to compare, not a guaranteed fix for every stuck build. See Storybook’s publishing guide and its GitHub Actions example.
- Escalate if it passes two hours. Contact support@chromatic.com or use Chromatic’s in-app chat. Include the build URL, approximate start time, CI provider, workflow run link, and relevant logs.
Use the two status pages to locate the stalled step
Chromatic’s CLI and GitHub Action publish a Storybook to Chromatic and can initiate tests when those tests are enabled. The CI run shows what happened in the workflow; the Chromatic build page shows the hosted build’s status. Neither view alone proves the root cause, so compare both before deciding whether the job is still working or needs escalation. See Storybook’s Chromatic integration documentation.
| What you see | What to check next |
|---|---|
| CI run is still active | Inspect the running Chromatic step and its latest logs; determine whether the workflow is progressing or waiting. |
| CI run completed, Chromatic still says in progress | Record both statuses and links, then check the elapsed time. If the Chromatic build remains stuck beyond two hours, contact Chromatic. |
| CI run failed | Read the failing step’s logs first. A CI failure and a Chromatic build still marked in progress are separate observations; the status alone does not establish why they differ. |
| A separate Storybook test-runner job is active | Check that job independently. Storybook’s test runner can run locally or in CI, while Chromatic is a cloud service for visual and component tests integrated with a git provider. The test-runner job’s state is not the same as the Chromatic build status; see the test-runner documentation. |
Check the workflow configuration
Use the published setup as a reference rather than changing settings at random. Confirm the basics below against your workflow and the relevant logs:
- The Chromatic project token is configured as a CI secret and exposed to the publishing step.
- The workflow checks out the repository and installs the project’s dependencies before publishing.
- The workflow uses a supported combination of platform, Node.js, and Storybook. Storybook’s integration page lists the latest LTS Ubuntu, Windows Server, and macOS versions; Node.js Current, Active, or Maintenance (LTS) releases; and Storybook 6.5 or later as supported. Other combinations may work but are not officially supported, and feature availability can vary by platform and version. Check the live compatibility information before making version-specific changes.
- You are checking the Chromatic publish/build step, not assuming that a separate test-runner job controls the Chromatic status. Storybook’s test-runner CI recipe includes a 60-minute job timeout in its example; that is the example job’s timeout, not Chromatic’s two-hour automatic-cancellation threshold.
When to contact Chromatic
Chromatic’s FAQ says a build stuck in progress is automatically cancelled after two hours. If the build remains in progress beyond that point, use support@chromatic.com or Chromatic’s in-app chat. Provide the build URL, start-time estimate, CI provider, workflow run URL, and logs so support can investigate the specific run. The published guidance gives this timeout and escalation route; it does not identify one universal cause for stuck builds.
#1 Best Overall
- Professional version of our popular DKK Card with n-Chrome coated color targets
- The color patches are 100% coated with DGK's n-Chrome process, allowing for a much higher level of color saturation, luminance, and accuracy, while getting rid of metamerism.
- Includes 2 DKC-Pro Cards - Each with Precision 12% and 18% Gray reference for white balance plus 18-Color patches for superior digital color correction
- For use with software such as Adobe Photoshop and Lightroom
Or skip the browser setup
Chromatic build troubleshooting is about the CI workflow and Chromatic’s build status. If you also need screenshots of the published Storybook page for a separate visual check, a screenshot API can capture a URL without setting up browser automation yourself. ScreenshotNeo is one option: it removes cookie/consent banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, and failed loads are not billed; and an MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots per month with no card, and paid plans start at $5 for 3,000.
One-call cURL example, with the ScreenshotNeo API documentation:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
Rank #2
- SUPERIOR IMAGE QUALITY - Achieve optimal lens performance with these high-resolution charts, ensuring your photos and videos are sharp, clear, and professional-grade every time.
- ENHANCED EASE OF USE - Simplify your lens testing and calibration process with these user-friendly 8.5x11" charts, designed for quick and accurate assessments of lens performance.
- GUARANTEED DURABILITY - Benefit from the robust construction of these chrome SD test charts, built to withstand frequent use and maintain their accuracy over extended periods.
- EXCELLENT PRICE VALUE - Get three high-quality lens test charts for comprehensive testing and calibration, offering exceptional value for professionals and enthusiasts alike.
- WIDE COMPATIBILITY - These versatile charts are ideal for lens testing, calibration, resolution, and color calibration across various digital photo and video equipment setups.
Sign up for 1,000 free screenshots a month, with no card required.
Quick Recap
Best Value
- 𝗖𝗢𝗟𝗢𝗥 𝗔𝗖𝗖𝗨𝗥𝗔𝗖𝗬, 𝗗𝗘𝗙𝗜𝗡𝗘𝗗 𝗗𝗘𝗧𝗔𝗜𝗟: Ensure accurate, consistent color from one shot to another, across different cameras, lenses, and lighting environments, plus capture every detail with optimal RAW process in- batch processing
- 𝗕𝗨𝗗𝗚𝗘𝗧 𝗙𝗥𝗜𝗘𝗡𝗗𝗟𝗬, 𝗙𝗘𝗔𝗧𝗨𝗥𝗘-𝗥𝗜𝗖𝗛: It features 24 spectrally engineered color targets and a grey face target, all near/within the sRGB gamut to ensure compatibility with a wide range of devices. Perfect for visual comparisons and custom white balance adjustments.
- 𝗔𝗟𝗜𝗚𝗡 𝗠𝗨𝗟𝗧𝗜𝗣𝗟𝗘 𝗖𝗔𝗠𝗘𝗥𝗔 𝗦𝗬𝗦𝗧𝗘𝗠𝗦: Easy alignment of multiple camera systems, including DSLR, Smartphones, drones and Action Cams - perfect for event photography.
- 𝗦𝗧𝗥𝗘𝗔𝗠𝗟𝗜𝗡𝗘𝗗 𝗪𝗢𝗥𝗞𝗙𝗟𝗢𝗪: Taking a test photo with your Spyder Checkr 24 allows you to capture scene light color and intensity data, so you can color-calibrate your camera with software based HSL-presets, streamlining post-production workflow
- 𝗢𝗡-𝗧𝗛𝗘-𝗚𝗢-𝗣𝗢𝗥𝗧𝗔𝗕𝗜𝗟𝗜𝗧𝗬: Its compact size and protective sleeve make Spyder Checkr 24 a take-with-you-everywhere photo tool – perfect for location shoots, changing light conditions, and multiple camera and lens usage – wherever your camera takes you!
Rank #4
- SUPERIOR ACCURACY - Ensures precise color calibration with two 5x7" DKK charts, providing a reliable reference for consistent image quality across all your video projects.
- ENHANCED IMAGE QUALITY - Achieve optimal color balance and exposure using the integrated colorbar and grayscale combo, designed for professional-grade video calibration.
- ULTIMATE PORTABILITY - Compact 5x7" size makes these charts easy to transport, ensuring accurate color calibration wherever your video shoots take you, enhancing ease of use.
- INCREASED DURABILITY - Built with high-quality materials, these calibration charts are designed to withstand frequent use, offering a long-lasting solution for video professionals.
- VERSATILE COMPATIBILITY - Works seamlessly with various video editing software and cameras, providing a universal solution for color calibration across different platforms.
Rank #3
- QUANTITY: Set of 2, Printed on SmartFlex Synthetic Paper with a matt finish coating to avoid glare
- AFFORDABLE: Professional color and gray target, at an affordable price
- PORTABLE: fit easily in your equipment bag
- PROFESSIONAL: Pixel Perfect offers full size, spectrally formulated pigment patches, and highly accurate FREE Adobe correction software
- EASY TO USE: Pixel Perfect provides easy-to-follow instructions and download link for Adobe DNG profile editor
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.
