# Chromatic

> description: Chromatic Acceptable Use Policy

## Pages

- [Acceptable Use Policy](account-acceptable-use.md): Chroma Software, Inc.®
- [Infrastructure upgrades](account-infrastructure-upgrades.md): Chromatic's browser infrastructure is periodically upgraded. This can lead to changes in how your stories render due ...
- [Notifications](account-notifications.md): Chromatic sends email notifications to keep [collaborators](/docs/collaborators) in the loop. You have control over w...
- [Open source sponsorships](account-open-source.md): Chromatic sponsors open source component libraries and design systems with free usage. As open source maintainers our...
- [Privacy Policy](account-privacy-policy.md): Chroma Software, Inc.®
- [Security](account-security.md): Our priority is securing your intellectual property and information.
- [Terms of Service](account-terms-of-service.md): Chroma Software, Inc.®
- [Access control](collaborate-access.md): Learn how to manage access to your Chromatic account and projects.
- [Collaborators](collaborate-collaborators.md): Chromatic keeps track of UI feedback and tests in one place so that collaborators stays aligned without you having to...
- [Composition](collaborate-composition.md): Chromatic publishes your Storybook to a secure CDN. That means you can combine published Storybooks with your local S...
- [Embed stories](collaborate-embed.md): Embed stories published to Chromatic in Medium articles, Notion pages, and countless other platforms.
- [Storybook Figma plugin](collaborate-figma-plugin.md): Storybook Connect is a Figma plugin that allows you to link stories to Figma components. Once linked, you can view yo...
- [Chromatic Markdown syntax](collaborate-markdown.md): Create sophisticated formatting for your prose and code in Chromatic with simple syntax.
- [Publish](collaborate-publish.md): The Chromatic CLI builds and publishes your Storybook to a secure online workspace, making all your stories accessibl...
- [Review](collaborate-review.md): As Chromatic's second core workflow, UI Review streamlines the process of getting approval and feedback on visual cha...
- [Browsers](configuration-browsers.md): UIs might look perfect in one browser but be broken in another. Chromatic helps you extend your test coverage to Chro...
- [Custom webhooks](configuration-custom-webhooks.md): You can integrate Chromatic into other services and script custom behavior to support advanced workflows using [webho...
- [isChromatic](configuration-ischromatic.md): The`isChromatic`method allows you to control how your Storybook tests run in the Chromatic environment. Use it to c...
- [Monorepos](configuration-monorepos.md): A common pattern in modern web development is monorepos -- having a single repository that contains multiple distinct...
- [Parameters & Globals](configuration-params.md): When using Chromatic with Storybook, you can control how a snapshot is captured via Storybook [parameters](https://st...
- [Slack](configuration-slack.md): Integrate Chromatic into your existing tools and services with [webhooks](https://en.wikipedia.org/wiki/Webhook).
- [Configure](cypress-configure.md): You can enhance your Cypress and Chromatic tests further by configuring them using the options outlined in the follow...
- [Targeted snapshots](cypress-targeted-snapshots.md): By default, Chromatic takes a snapshot at the end of every Cypress test, whether it passes or fails. However, you can...
- [Combine stories & E2E](guides-combine-stories-e2e.md): Developing a robust UI testing strategy often involves combining component-level and end-to-end (E2E) tests. While St...
- [Configure Chromatic features via Storybook params](guides-config-with-story-params.md): When using Chromatic with Storybook, you can control the snapshot capturing behavior through Storybook parameters. [P...
- [Globs](guides-globs.md): Chromatic options like`onlyStoryFiles`and`externals`allow you to include or exclude specific files or directories...
- [Chromatic for designers](guides-guide-for-designers.md): Chromatic helps designers collaborate with developers on UI implementation.
- [In development workflow](guides-in-development.md): Chromatic automates UI development so you can build features faster, with less manual work. Follow along with our rec...
- [In pull request workflow](guides-in-pull-request.md): Chromatic serves as a single hub that allows you to test, approve PRs, and share feedback. During the pull request, C...
- [Mandatory PR checks](guides-mandatory-pr-checks.md): When you link your Chromatic project to a GitHub, Bitbucket, or GitLab repository, Chromatic provides status checks d...
- [Manual UI Review](guides-manual-ui-review.md): Manual UI Review helps you see the visual differences between any pair of branches - even if your project isn't conne...
- [Interaction tests](interactiontests-interactions.md): Interaction tests enable you to verify how a component responds to user behaviors like click, type, keyboard, and hov...
- [Testing Shadow DOM](interactiontests-shadow-dom.md): With the help of [shadow-dom-testing-library](https://github.com/konnorrogers/shadow-dom-testing-library), you can wr...
- [Configure browser options in Modes](modes-browser-options.md): Components adapt styling and layouts based on device characteristics. With Chromatic, developers can configure specif...
- [Custom decorators and globals](modes-custom-decorators.md): ℹ️  This feature uses the modes API. Learn how to get started.
- [Viewports (legacy)](modes-legacy-viewports.md): UI components can respond to device width. Chromatic makes it easy to visual test these cases with the`viewports`pa...
- [Themes](modes-themes.md): ℹ️  This feature uses the modes API. Learn how to get started.
- [Infrastructure release notes](notinnavigation-infrastructure-release-notes.md): Welcome to`Chromatic Capture Cloud version 8`released October 2025.
- [Promotion code eligibility](notinnavigation-promotion-eligibility.md): We're thrilled to welcome new customers to Chromatic with a signup credit. Check if you're eligible using the criteri...
- [Sunsetting `--preserve-missing`](notinnavigation-sunsetting-preserve-missing.md): 🚨  Support for the --preserve-missing CLI flag has been removed completely as of May, 2023. If...
- [Upgrading webhooks to the latest version](notinnavigation-upgrading-webhooks.md): If you currently have a v1 custom webhooks integration, you'll be receiving`POST`request payloads like this:
- [Sharding](playwright-sharding.md): When running your Playwright tests over multiple shared CI jobs, you'll need to wait for all jobs to complete, ensuri...
- [Targeted snapshots](playwright-targeted-snapshots.md): By default, Chromatic takes a snapshot at the end of every Playwright test, whether it passes or fails. However, you ...
- [Branches and baselines](snapshot-branching-and-baselines.md): This document describes how Chromatic decides what snapshots to compare when using UI Tests or UI Review.
- [Font loading](snapshot-font-loading.md): Browsers can decide to render HTML in multiple passes when custom fonts are used. They do this to speed up the time-t...
- [Position sticky & fixed](snapshot-position-sticky.md): Chromatic captures`position:sticky`and`position:fixed`elements in their initial positions once per snapshot.
- [Resource loading](snapshot-resource-loading.md): Chromatic waits for resources like images and fonts to load before capturing a snapshot. When resources fail to load,...
- [Snapshots](snapshot-snapshots.md): A **snapshot** is an image of the UI rendered by a test, along with metadata captured in Chromatic’s Capture Cloud in...
- [Troubleshooting Snapshots](snapshot-troubleshooting-snapshots.md): Did you encounter inconsistent, blank, or other rendering issues in your snapshots? This guide helps you identify com...
- [Are there any ports required to run Chromatic?](troubleshooting-faq-are-ports-required.md): To ensure Chromatic runs smoothly, you must open port 443.
- [How can I automatically trigger a UI Review?](troubleshooting-faq-automate-ui-reviews.md): UI Reviews are triggered automatically when your project is [linked](/docs/access#linked-projects) to a Git provider ...
- [Why is my build failing with component errors?](troubleshooting-faq-build-fails-component-errors.md): When a test fails to render, the associated build will be badged with a "Component error" label. This means that Chro...
- [How does TurboSnap work with UI Tests and UI Review?](troubleshooting-faq-how-does-turbosnap-work-with-ui-tests-and-ui-review.md): TurboSnap is a feature that's part of [**UI Tests**](/docs), not UI Review. Understanding this distinction is crucial...
- [Is my stack compatible with Chromatic?](troubleshooting-faq-stack-compatibility.md): If you use [Playwright](/docs/playwright) and [Cypress](/docs/cypress), you can find supported versions [here](/docs/...
- [Why are my tunneled builds failing?](troubleshooting-faq-tunneled-builds.md): Running Chromatic builds via the tunnel option is no longer supported with the release of Chromatic CLI v2.0.0. We re...
- [Why do tests show as new in builds?](troubleshooting-faq-why-tests-show-as-new.md): Tests are identified by their **test name**, which is a combination of key elements in the test file. If any of these...
- [Support](troubleshooting-support.md): The fastest way to get help is to search the docs and browse our [FAQ](/docs/FAQ).
- [TurboSnap best practices](turbosnap-turbosnap-best-practices.md): Most everyone agrees it's important to test your UI, but it's even more important to make sure you're testing the _ri...
- [Optimizing TurboSnap for monorepos](turbosnap-turbosnap-for-monorepos.md): For large teams using a monorepo and managing changes across dozens of packages, it's crucial not just to run tests f...
- [Configure](accessibilitytests-accessibility-configure.md): You can configure Chromatic's accessibility tests to match your project's specific requirements. By default, Chromati...
- [Dashboard](accessibilitytests-accessibility-dashboard.md): The Accessibility dashboard offers a comprehensive overview of accessibility issues in your components. Chromatic con...
- [Usage](accessibilitytests-accessibility-usage.md): import InstallSnippets from "../../components/InstallSnippets.astro";
- [Accessibility Tests](accessibilitytests-accessibility.md): import { YouTubeCallout } from "../../components/YouTubeCallout";
- [Billing](account-billing.md): import { SnapshotCalculator } from "../../components/SnapshotCalculator/SnapshotCalculator";
- [Automate Chromatic with Azure](ci-azure-pipelines.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with BitBucket](ci-bitbucket-pipelines.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate with CI](ci-ci.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with CircleCI](ci-circleci.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with your custom CI provider](ci-custom-ci-provider.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with GitHub Actions](ci-github-actions.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with GitLab](ci-gitlab.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with Jenkins](ci-jenkins.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with Semaphore](ci-semaphore.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Automate Chromatic with Travis CI](ci-travisci.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Figma in Chromatic](collaborate-figma-in-chromatic.md): import { YouTubeCallout } from "../../components/YouTubeCallout";
- [Permalinks](collaborate-permalinks.md): import permalinksCustomDomain from "../../images/permalinks-custom-domain-form.png";
- [CLI](configuration-cli.md): import { TabItem, Tabs } from "../../components/Tabs";
- [Configuration reference](configuration-configure.md): import ConfigurationOptions from "../../components/ConfigurationOptions/ConfigurationOptions.astro";
- [Setup](cypress-setup.md): import DemoChromaticUnlinked from "../../shared-snippets/demo-chromatic-unlinked.mdx";
- [Mocking APIs and Network Requests](guides-mock-network-requests.md): import { YouTubeCallout } from "../../components/YouTubeCallout";
- [Using Chromatic with Nx](guides-nx.md): [Nx](https://nx.dev/) is a powerful monorepo tool that helps developers optimize builds and CI/CD execution. When com...
- [Story Modes](modes-modes.md): Global-level configurations (globals) such as viewport size, theme (light/dark), and locale impact how a component re...
- [Viewports](modes-viewports.md): import { TabItem, Tabs } from "../../components/Tabs";
- [E2E Visual Tests upgrade guide](notinnavigation-e2e-upgrade-guide.md): import { TabItem, Tabs } from "../../components/Tabs";
- [Why Chromatic?](overview-introduction.md): import { YouTubeCallout } from "../../components/YouTubeCallout";
- [Quickstart](overview-quickstart.md): import TroubleshootingSetup from "../../shared-snippets/setup/troubleshooting.mdx";
- [Configure](playwright-configure.md): import { TabItem, Tabs } from "../../components/Tabs";
- [Setup](playwright-setup.md): import DemoChromaticUnlinked from "../../shared-snippets/demo-chromatic-unlinked.mdx";
- [Animations](snapshot-animations.md): import ParamsCallout from "../../components/ParamsCallout.astro";
- [Delay](snapshot-delay.md): import ParamsCallout from "../../components/ParamsCallout.astro";
- [Disable snapshots](snapshot-disable-snapshots.md): import ParamsCallout from "../../components/ParamsCallout.astro";
- [Hover and focus states](snapshot-hoverfocus.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Ignore tests and elements](snapshot-ignoring-elements.md): import ParamsCallout from "../../components/ParamsCallout.astro";
- [Media features](snapshot-media-features.md): import ParamsCallout from "../../components/ParamsCallout.astro";
- [Page Shift Detection](snapshot-page-shift-detection.md): When elements are added to the UI, the surrounding content shifts vertically. This shift is detected by Chromatic's c...
- [Threshold](snapshot-threshold.md): import ParamsCallout from "../../components/ParamsCallout.astro";
- [Viewports](snapshot-viewports.md): UI components respond and adapt to different device widths. Chromatic streamlines visual testing, enabling you to cap...
- [Why can't I see the 1up/2up feature in Chromatic?](troubleshooting-faq-1up-2up-feature.md): If you’re unable to see the 1up/2up feature, it's likely because there’s no baseline snapshot to compare against.
- [How do I add chromatic.com to my allowlist if my resources are behind a firewall?](troubleshooting-faq-add-chromatic-to-allowlist-if-my-resources-are-behind-a-fire.md): You will need to make sure that`chromatic.com`is added to the allowed list in your firewall settings. Since`chroma...
- [My organization restricts IP addresses for Git access. Should I add Chromatic to the allowlist?](troubleshooting-faq-allowlist-ips-for-git-providers.md): Yes, you must add Chromatic's IP addresses to the allow list by following the instructions provided in the [GitHub](h...
- [Can I use BDD with Playwright?](troubleshooting-faq-bdd-with-playwright.md): import { TabItem, Tabs } from "../../../components/Tabs";
- [Does adding more browser coverage add time to my tests?](troubleshooting-faq-browser-coverage-test-time.md): Yes it can. We do our best to provide the fastest test speeds but there are limits to browser performance even when s...
- [How do browsers affect my snapshot count?](troubleshooting-faq-browsers-affect-snapshot-count.md): Each browser adds another snapshot for each of your stories. For example, if you have a story that is tested in Chrom...
- [Can I get rid of my BrowserStack or Sauce subscription?](troubleshooting-faq-browserstack-sauce-subscription-cancellation.md): Our aim isn’t to replace services like Browserstack or Sauce. Cloud browser services are invaluable for verifying int...
- [Why is my build failing with the error message Build verification timed out?](troubleshooting-faq-build-verification-timeout.md): As your project grows and you add more components to test, you may hit time-out errors. To resolve this issue, try co...
- [Can I only take snapshots when a component's code changes?](troubleshooting-faq-can-i-only-take-snapshots-on-code-change.md): We recommend taking snapshots on every build because it's the most reliable way to catch UI regressions. Global depen...
- [How do I cancel a build?](troubleshooting-faq-cancel-a-build.md): Chromatic automatically cancels a build that is stuck in progress for 2 hours. If a build has been stuck in progress ...
- [Can I change which browser generates comparisons for UI Review?](troubleshooting-faq-change-browser-ui-review-comparisons.md): No. At the moment, Chrome is fixed as the browser used for UI review.
- [How can I change my Chromatic plan?](troubleshooting-faq-change-chromatic-plan.md): To change your Chromatic plan, you'll need to do the following:
- [How do I change my email and password?](troubleshooting-faq-change-email-password.md): If you signed up via OAuth, Chromatic will retrieve the email addresses associated with your account from your Git pr...
- [How can I change my profile picture?](troubleshooting-faq-change-profile-picture.md): It is possible to change the profile picture for email/password and single sign-on (SSO) accounts by using Gravatar. ...
- [How do I change my username?](troubleshooting-faq-change-username.md): If you signed up via email, you'll be assigned a username based on your email. Go to the Profile page to change your ...
- [Does Chromatic work with Azure DevOps?](troubleshooting-faq-chromatic-azure-devops.md): Chromatic is a CI-powered service. That means you can run`chromatic`in any CI workflow including Azure DevOps. Howe...
- [How to run Chromatic on a specific branch or only when merging to main?](troubleshooting-faq-chromatic-branch-merge-main.md): How Chromatic is triggered depends on your Continuous Integration (CI) setup. You can configure your CI provider to r...
- [Why can't the Chromatic CLI find git during CI?](troubleshooting-faq-chromatic-cli-cant-find-git-ci.md): Pipeline configurations allow you to specify the docker image that you'd like to use for your runners. To keep the im...
- [What is the chromatic-diagnostics.json file?](troubleshooting-faq-chromatic-diagnostics.md): The`chromatic-diagnostics.json`file is a detailed report generated during a build that contains the build's context...
- [How to skip Chromatic runs for draft PRs?](troubleshooting-faq-chromatic-draft-pr.md): Chromatic provides flags like [`--skip`](/docs/configure#skip) to bypass builds and [`--skip-update-check`](/docs/con...
- [Is there a trial period on Chromatic's free plan?](troubleshooting-faq-chromatic-free-plan.md): There is no trial period at Chromatic - users can enjoy the features of the free plan indefinitely without worrying a...
- [Do you support mobile testing?](troubleshooting-faq-chromatic-mobile-testing.md): Chromatic doesn't currently support mobile testing, but you can test your UI at smaller viewport sizes using:
- [How to setup an unlinked Chromatic project (if you require SSO, on-premises, or have a different Git provider)](troubleshooting-faq-chromatic-sso-on-premises-other-git.md): import SetupChromaticUnlinked from "../../../shared-snippets/setup-unlinked-project.md";
- [How to run Chromatic on UI-related commits only?](troubleshooting-faq-chromatic-ui-related-commits.md): Chromatic provides flags like [`--skip`](/docs/configure#skip) to bypass builds and [`--skip-update-check`](/docs/con...
- [How is Chromatic different from visual testing tools like Applitools and Percy?](troubleshooting-faq-chromatic-vs-applitools-percy.md): Chromatic is a faster, easier to use, and cost-effective alternative to Applitools or Percy that is built for UI comp...
- [How do I link my Git account to my Chromatic account?](troubleshooting-faq-connect-git-user-to-chromatic-user.md): If you registered your Chromatic account using an email and password, you can link it to a Git provider like GitHub o...
- [How to debug the Chromatic archive locally?](troubleshooting-faq-debug-archive.md): You should debug the archive locally if you suspect that an E2E project issue is related to the Chromatic archive **n...
- [How do I delete a build?](troubleshooting-faq-delete-a-build.md): Builds are used heavily in our baseline algorithms which brings complexity when deleting individual links in the chai...
- [How do I delete a project?](troubleshooting-faq-delete-a-project.md): To remove a project, you'll need to follow the steps below:
- [How do I delete my profile?](troubleshooting-faq-delete-my-profile.md): To delete your Chromatic profile, you'll need to do the following:
- [Fixing a 'detached HEAD' state in CI](troubleshooting-faq-detached-state.md): A **detached HEAD state** occurs when your CI provider checks out a specific commit instead of a branch, losing the G...
- [What is the difference between 'Snapshot' and 'Canvas'?](troubleshooting-faq-difference-between-canvas-snapshot.md): **Canvas** is an interactive environment that renders your test code live in the browser. With Storybook, it displays...
- [What is the difference between a standard UI Review and a manual UI Review?](troubleshooting-faq-difference-between-manual-ui-review-and-ui-review.md): Standard UI Reviews are linked to a specific pull or merge request and are automatically triggered when you open one....
- [What is the difference between a 'Test' and a 'Snapshot'?](troubleshooting-faq-difference-between-test-and-snapshot.md): A test is the expression of a piece of UI in a specific state. Chromatic uses tests to verify [visual appearance](/do...
- [What's the difference between Figma in Chromatic and Figma Plugin?](troubleshooting-faq-difference-figmaplugin-figmainchromatic.md): [Figma in Chromatic](/docs/figma-in-chromatic) brings designs into Chromatic for side-by-side comparison with stories...
- [What is the difference between the 'accepted' and 'inherited' baseline?](troubleshooting-faq-difference-inherited-accepted-baseline.md): The **accepted** baseline is the test when a new baseline was accepted.
- [Can I disable Chrome?](troubleshooting-faq-disable-chrome.md): All plans use Chrome by default because it offers the greatest test coverage for most people. It cannot be disabled.
- [What happens if I disable UI Tests and/or UI Review?](troubleshooting-faq-disable-ui-tests-and-or-review.md): As long as either the testing or review features are enabled, Chromatic will continue taking snapshots. With both dis...
- [Do snapshots for old builds ever expire in Chromatic?](troubleshooting-faq-do-builds-expire.md): At this time, Chromatic doesn't automatically delete old builds or snapshots.
- [How can I edit my billing email?](troubleshooting-faq-edit-billing-email.md): Chromatic sets the account's billing email address to the email address of the person who signed up to the plan. Chro...
- [What happens if I update my plan before the end of the billing period?](troubleshooting-faq-end-of-billing-period.md): If you update your paid plan before the end of the billing period and you still have unused time, we will credit you ...
- [How to set Chromatic environment variables in popular CI providers?](troubleshooting-faq-environment-variables.md): Environment variables define settings for your CI workflow which Chromatic relies on to get git context, such as the ...
- [Are there any restrictions for external collaborators?](troubleshooting-faq-external-collaborators.md): External collaborators do not have the same permissions as collaborators linked to git providers.
- [Why am I receiving a failed to login as OAuth user error ?](troubleshooting-faq-failed-to-login.md): If you're encountering issues with linking your Git provider to Chromatic, one of the most common reasons for this er...
- [Does Figma in Chromatic display the name or value of design tokens?](troubleshooting-faq-figma-in-chromatic-tokens-in-designs-tab.md): Chromatic will display the _value_ of a design token within the Designs tab of the component library. This helps deve...
- [Does the Figma integration sync automatically?](troubleshooting-faq-figma-integration-auto-sync.md): Yes. Chromatic automatically updates your linked stories to reflect the latest build on the designated branch. That m...
- [What types of Figma links does Chromatic support?](troubleshooting-faq-figma-links.md): Chromatic currently only supports linking to Figma components.
- [What permissions do I need in Figma?](troubleshooting-faq-figma-permissions.md): You require a Figma`editor`role to both link and view stories with this plugin.
- [How do I filter builds by name on the Builds page?](troubleshooting-faq-filter-builds.md): On the Builds page, go to the branch picker and find the branch by name in the search field. By default, the Builds p...
- [Where can I find my project token?](troubleshooting-faq-find-project-token.md): The project token is available on the Manage → Configure page of your project.
- [What happens when I run out of snapshots on the free plan?](troubleshooting-faq-free-plan-snapshot-limit.md): Free plans come with 5000 snapshots per month. Once free snapshots are exhausted, testing & review will become paused...
- [How do I get the published Storybook output URL through the CI pipeline?](troubleshooting-faq-get-published-storybook-url-via-ci.md): 1. Add the`--diagnostics-file`flag to your Chromatic command/script to generate the`chromatic-diagnostics.json`file.
- [What happens if I exceed the snapshot limit?](troubleshooting-faq-hit-snapshot-limit.md): Once you reach your **snapshot limit**, the outcome varies depending on your account type.
- [How do I change the git email attached to my account?](troubleshooting-faq-how-do-i-change-the-git-email-attached-to-my-account.md): To change your git email attached to your account, you'll need to do the following:
- [How do I turn off TurboSnap?](troubleshooting-faq-how-do-i-turn-off-turbosnap.md): TurboSnap is an opt-in feature. You can't configure it through the Chromatic web app. Instead, it is controlled via t...
- [How is this compared to end-to-end testing tools like Playwright and Cypress?](troubleshooting-faq-how-is-this-compared-to-playwright-and-cypress.md): Chromatic complements your existing end-to-end tests in Playwright, Cypress, or Selenium.
- [How many collaborators can I invite to my account?](troubleshooting-faq-how-many-collaborators.md): There are no limitations on the number of collaborators you can have on your account.
- [How do permissions work?](troubleshooting-faq-how-permissions-work.md): Figma users must have access to the Chromatic project in order to use the plugin. That means Figma collaborators (vie...
- [Why are my branch names different in Chromatic?](troubleshooting-faq-incorrect-branch-names.md): Chromatic depends on your CI system to pass Git details like branch names and commit SHAs. Some CI tools, including _...
- [How do we run an interaction test when snapshots are disabled for a story?](troubleshooting-faq-interaction-test-disabled-with-disablesnapshot.md): The`disableSnapshot`parameter disables snapshotting and interaction testing for a test. If you've disabled snapshot...
- [Is it possible to run interaction tests in Chromatic without creating snapshots?](troubleshooting-faq-interaction-tests-without-snapshots.md): Interaction tests in Chromatic will always generate snapshots - running
- [Is VPN supported?](troubleshooting-faq-is-vpn-supported.md): Using a VPN is supported. If your organization has **IP** restrictions enabled, you'll need to add [our IPs](/docs/fa...
- [Using and understanding Chromatic JUnit report](troubleshooting-faq-junit-report-usage.md): You can generate a JUnit XML report by setting the flag`junitReport`when you run Chromatic. This report is a valuab...
- [How can I limit access to a GitHub repository?](troubleshooting-faq-limit-repository-access.md): To limit access to your GitHub repository, you'll need to do the following:
- [How do I link a repository to my project?](troubleshooting-faq-link-a-repository.md): If your repository is part of a git entity, you must get the access request approved by an admin at the organization ...
- [I hit error 'unable to get local issuer certificate' when running Chromatic. How do I fix this?](troubleshooting-faq-local-certificate-error.md): The local certificate error typically is caused by your local certificate store in Mac OS, Node, or it may be due to ...
- [How should ref be configured for merge_group and pull_request builds?](troubleshooting-faq-merge-queue-ref.md): Since [TurboSnap does not support the`pull_request`event](/docs/turbosnap/setup#github-pull_request-triggers), you'...
- [Do the onlyStoryNames and onlyStoryFiles options have similar retest logic to TurboSnap?](troubleshooting-faq-only-story-rebuilds.md): While TurboSnap avoids false positives by [retesting impactful situations](/docs/turbosnap#full-rebuilds), the`onlyS...
- [Override the branch name for certain CI providers](troubleshooting-faq-override-branch-name.md): In some cases, Chromatic's automatic CI detection is unable to figure out the branch name associated with a build. Yo...
- [What happens when I switch from a paid plan to a free plan before the billing cycle ends?](troubleshooting-faq-paid-plan-to-free-plan.md): Your paid subscription with Chromatic will end immediately once cancelled or switched over to a free plan. You will r...
- [Where can I find projects shared with me?](troubleshooting-faq-projects-shared-with-me.md): You can find projects that are shared with you in the menu tab in the upper-left corner where you will see a section ...
- [What if I already publish Storybook using S3, Heroku, Netlify, or Vercel?](troubleshooting-faq-publish-storybook-s3-heroku-netlify-vercel.md): You don't need to do this anymore. Chromatic is a Storybook-optimized cloud service for frontend teams that includes ...
- [How do I rename a project?](troubleshooting-faq-rename-project.md): To rename a project, you'll need to do the following:
- [Do I get charged for snapshots when I rerun a build?](troubleshooting-faq-rerun-builds-charged.md): When you rerun a build by clicking the rerun button on the UI Test page, Chromatic only charges for snapshots taken f...
- [How do I reset my password?](troubleshooting-faq-reset-password.md): To reset your password, press`Reset It!`directly on the [sign-in page](https://www.chromatic.com/start) and enter t...
- [Can I reset or cycle my project token?](troubleshooting-faq-reset-project-token.md): Users with the [`owner`](/docs/collaborators#roles) role can reset or cycle project tokens on the Configure page of y...
- [How do I set up notifications?](troubleshooting-faq-set-notifications.md): To set up notifications on your account, you'll need to do the following:
- [Can billing be shared across multiple Chromatic accounts?](troubleshooting-faq-share-billing.md): Chromatic no longer supports sharing a single self-serve paid plan across multiple accounts (for example, across diff...
- [Can I skip running builds for the main branch to save snapshots?](troubleshooting-faq-skip-running-builds.md): In many cases (such as GitHub with the Chromatic app or Bitbucket), baseline history will still be preserved through ...
- [What happens to my snapshots if I don't use them?](troubleshooting-faq-snapshots-unused.md): Chromatic will reset the snapshot count monthly, calculated based on the day you've signed up. For instance, if you s...
- [Is Single Sign-on (SSO) available on the Starter or Pro plans?](troubleshooting-faq-sso-plans.md): No Single Sign-on (SSO) is not available on self-serve plans like Starter or Pro. It's only available on Enterprise p...
- [Why is my Storybook failing to load in Chromatic's Canvas tab?](troubleshooting-faq-storybook-chromatic-canvas-load-failure.md): If your stories make use of non-HTTPS content (for instance, images), the iframe
- [Can you choose which version of the design from a Storybook is shown in Figma?](troubleshooting-faq-storybook-design-version-figma.md): Yes, you can select which branch's stories are connected to Figma.
- [Can I use my Storybook in development mode to run a Chromatic build?](troubleshooting-faq-storybook-use-development-mode-to-build-chromatic.md): Although you can use a development build of your Storybook with Chromatic, we recommend against it. Instead, use a pr...
- [How can I switch my connected Figma account to a new one?](troubleshooting-faq-switch-figma-account.md): If you connected the wrong Figma account, you're able to disconnect from Figma and connect the correct account. To di...
- [What about testing in every other browser and its versions?](troubleshooting-faq-testing-in-other-browsers-and-versions.md): Chromatic covers the major rendering engines (Blink, Gecko and Webkit) at all viewports. This eliminates almost all b...
- [How are timestamps displayed in Chromatic web app?](troubleshooting-faq-timestamps.md): While our server infrastructure is in UTC, Chromatic web app displays all timestamps (e.g., on the build and billing ...
- [How do I transfer account ownership to another user?](troubleshooting-faq-transfer-ownership.md): To transfer ownership, you will need to assign another collaborator with the owner role - please note they must be a ...
- [How do I transfer my account's subscription to another account?](troubleshooting-faq-transfer-subscription.md): If you would like to transfer your subscription to another account, please get in touch with our **in-app chat** or e...
- [Why isn’t TurboSnap working for me?](troubleshooting-faq-turbosnap-not-working.md): You may be missing one of the necessary [prerequisites](/docs/turbosnap/setup#prerequisites). For [debugging informat...
- [What are the different type of Chromatic builds?](troubleshooting-faq-types-of-builds.md): The standard Chromatic build triggered by the [CLI](/docs/cli) or via [CI](/docs/ci). Chromatic captures a snapshots ...
- [How is UI Review different from UI Tests?](troubleshooting-faq-ui-review-vs-ui-tests.md): In a nutshell, [**UI Tests**](/docs) prevent regressions (bugs), while [**UI Review**](/docs/review) is for gathering...
- [Do I use more snapshots when both UI Tests and UI Review are enabled?](troubleshooting-faq-ui-tests-and-ui-review-snapshots.md): No. Snapshots taken for one workflow are reused for the other. You don't get charged twice.
- [I hit the error Unrecognized key {X} in chromatic.config.json](troubleshooting-faq-unrecognized-key-x-in-chromatic-config.md): If you encounter the error`Unrecognized key {X}`in`chromatic.config.json`, you may be using a flag in the`chromat...
- [What is an archive?](troubleshooting-faq-what-is-archive.md): An **archive** is a self-contained, re-renderable HTML “snapshot” of your UI captured during Playwright or Cypress te...
- [Why can't I see any of my projects?](troubleshooting-faq-where-are-my-projects.md): To locate your Chromatic project, you should start at the account level where all your projects are listed.
- [Why are the story names in Chromatic different than what I have in Storybook?](troubleshooting-faq-why-are-storybook-and-chromatic-story-names-different.md): Chromatic follows Storybook's [naming best practice](https://storybook.js.org/docs/writing-stories/naming-components-...
- [FAQs](troubleshooting-faq.md): If you have a question not covered in our documentation, contact us via our in-app chat.
- [Diagnose preview rebuilds](turbosnap-preview-rebuilds.md): Global decorators or parameters can affect every story. Therefore, TurboSnap retests everything whenever any file imp...
- [Setup TurboSnap](turbosnap-setup-turbosnap.md): import { YouTubeCallout } from "../../components/YouTubeCallout";
- [Mastering Chromatic's trace utility](turbosnap-trace-utility.md): import { YouTubeCallout } from "../../components/YouTubeCallout";
- [Troubleshooting TurboSnap](turbosnap-troubleshooting-turbosnap.md): import { YouTubeCallout } from "../../components/YouTubeCallout";
- [TurboSnap dependency tracing](turbosnap-turbosnap-dependency-tracing.md): TurboSnap examines your project's Git history and Webpack's dependency graph to determine which stories might be affe...
- [Introduction to TurboSnap](turbosnap-turbosnap.md): TurboSnap is an advanced Chromatic feature that speeds up [UI Tests](/docs#test-how-uis-look--function). It analyzes ...
- [Diff Inspector](visualtests-diff-inspector.md): import IntegrationSnippets from "../../components/IntegrationSnippets.astro";
- [Visual Tests addon for Storybook](visualtests-visual-tests-addon.md): import InstallSnippets from "../../components/InstallSnippets.astro";
- [Visual tests](visualtests-visual.md): import { YouTubeCallout } from "../../components/YouTubeCallout";