Frequently asked questions
If you have a question not covered in our documentation, contact us via our in-app chat.
Comparison with other tools
- How is this compared to end-to-end testing tools like Playwright and Cypress?
- Can I get rid of my BrowserStack or Sauce subscription?
- How is Chromatic different from visual testing tools like Applitools and Percy?
- What if I already publish Storybook using S3, Heroku, Netlify, or Vercel?
Usage
- How is UI Review different from UI Tests?
- Can I only take snapshots when a component's code changes?
- Is it possible to run interaction tests in Chromatic without creating snapshots?
- What happens when I run out of snapshots on the free plan?
- Can I skip running builds for the main branch to save snapshots?
- What happens to my snapshots if I don't use them?
- How do I cancel a build?
- How to setup an unlinked Chromatic project (if you require SSO, on-premises, or have a different Git provider)
- How do I delete a build?
- How do I filter builds by name on the Builds page?
- Where can I find my project token?
- What happens if I exceed the snapshot limit?
- How can I limit access to a GitHub repository?
- How do I link a repository to my project?
- What happens when I switch from a paid plan to a free plan before the billing cycle ends?
- How do I rename a project?
- Do I get charged for snapshots when I rerun a build?
- Where can I find projects shared with me?
- Can I reset or cycle my project token?
- Can I use my Storybook in development mode to run a Chromatic build?
- How are timestamps displayed in Chromatic web app?
- Why are my tunneled builds failing?
- What are the different type of Chromatic builds?
- Why can't I see any of my projects?
- Why are the story names in Chromatic different than what I have in Storybook?
Browsers
- Can I disable Chrome?
- Does adding more browser coverage add time to my tests?
- How do browsers affect my snapshot count?
- Can I change which browser generates comparisons for UI Review?
- What about testing in every other browser and its versions?
UI Tests and UI Review
- How can I automatically trigger a UI Review?
- Why can't I see the 1up/2up feature in Chromatic?
- Can I use BDD with Playwright?
- Why is my build failing with component errors?
- What is the difference between 'Snapshot' and 'Canvas'?
- What is the difference between a standard UI Review and a manual UI Review?
- What is the difference between a 'Test' and a 'Snapshot'?
- What happens if I disable UI Tests and/or UI Review?
- How do we run an interaction test when snapshots are disabled for a story?
- Do I use more snapshots when both UI Tests and UI Review are enabled?
- What is an archive?
- Why do tests show as new in builds?
- How does TurboSnap work with UI Tests and UI Review?
- Using and understanding Chromatic JUnit report
- What is the chromatic-diagnostics.json file?
- How to debug the Chromatic archive locally?
Publish
Continuous Integration
- Why is my build failing with the error message Build verification timed out?
- How to run Chromatic on a specific branch or only when merging to main?
- Why can't the Chromatic CLI find git during CI?
- How do I get the published Storybook output URL through the CI pipeline?
- Why are my branch names different in Chromatic?
- Override the branch name for certain CI providers
- I hit the error Unrecognized key {X} in chromatic.config.json
- How to skip Chromatic runs for draft PRs?
- How to run Chromatic on UI-related commits only?
- Fixing a 'detached HEAD' state in CI
- How to set Chromatic environment variables in popular CI providers?
TurboSnap
- Do the onlyStoryNames and onlyStoryFiles options have similar retest logic to TurboSnap?
- Why isn’t TurboSnap working for me?
Storybook Connect Figma plugin
- What's the difference between Figma in Chromatic and Figma Plugin?
- Does the Figma integration sync automatically?
- What permissions do I need in Figma?
- How do permissions work?
- Can you choose which version of the design from a Storybook is shown in Figma?
- How can I switch my connected Figma account to a new one?
- What types of Figma links does Chromatic support?
Figma in Chromatic
Compatibility
- Are there any ports required to run Chromatic?
- Is my stack compatible with Chromatic?
- How do I add chromatic.com to my allowlist if my resources are behind a firewall?
- Does Chromatic work with Azure DevOps?
- Do you support mobile testing?
Your account
- How many collaborators can I invite to my account?
- How do I reset my password?
- How do I set up notifications?
- Do snapshots for old builds ever expire in Chromatic?
- Are there any restrictions for external collaborators?
- How can I change my Chromatic plan?
- How do I change my email and password?
- How can I change my profile picture?
- How do I change my username?
- Is there a trial period on Chromatic's free plan?
- How do I link my Git account to my Chromatic account?
- How do I delete my profile?
- How do I delete a project?
- How can I edit my billing email?
- What happens if I update my plan before the end of the billing period?
- Why am I receiving a failed to login as OAuth user error ?
- How do I change the git email attached to my account?
- Is Single Sign-on (SSO) available on the Starter or Pro plans?
- How do I transfer account ownership to another user?
- How do I transfer my account's subscription to another account?