# What changed in @chromatic-com/storybook

> 30 changes in @chromatic-com/storybook 3 to 5 from its official release notes, upgrade guides and advisories: 4 breaking, 1 security, 4 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@chromatic-com/storybook/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @chromatic-com/storybook 5

### Breaking changes

- Replaces the device_code OAuth flow with the authorization_code flow. (5.2.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.0)

### Security

- Adds a refresh-token auth flow and hardens HTML injection paths. (5.2.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.0)

### New APIs and options

- Adds an Accept action for ignored tests. (5.4.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.4.0)
- Shows Ignored, Auto-ignored, Quarantined, and Unstable badges. (5.4.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.4.0)
- Adds an Unquarantine action for quarantined tests. (5.4.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.4.0)
- Adds clear() to the test provider to clear visual test statuses. (5.1.2) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.1.2)

### Performance

- Loads chromatic/node lazily so preset registration stays cheap. (5.3.1) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.3.1)

### Behavior and default changes

- The addon now respects Chromatic API rate limit headers. (5.5.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.5.0)
- Adds project ID validation. (5.3.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.3.0)

### Tooling

- Adds a tool for quickly publishing a Storybook. (5.2.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.0)
- Adds a tool to highlight ignored elements. (5.1.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.1.0)

### Fixes and other changes

- The addon now supports the clickable highlight menu item API. (5.5.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.5.0)
- Adds a link to the quarantine dashboard from the actions menu. (5.4.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.4.0)
- Hides Run tests when snapshot review actions already occupy that slot. (5.4.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.4.0)
- Restored sidebar status icons for large Storybooks. (5.3.1) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.3.1)
- Broadened the peer dependency version range to include Storybook 11.0.0-0, allowing compatibility with that prerelease. (5.3.1) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.3.1)
- Renders DPR 2 snapshots at the correct display size. (5.3.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.3.0)
- Fixes a premature GitError while Git information is loading. (5.3.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.3.0)
- Widened the peer-dependency range for Storybook, allowing compatibility with a broader range of Storybook versions. (5.2.1) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.1)
- Fixes the OAuth authorization_code flow. (5.2.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.0)
- Adds the missing ChromaticTypes export to support composite mode. (5.2.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.0)
- Shows share expiry based on the daysToExpire value from the CLI. (5.2.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.0)
- Refreshes authentication preemptively before the token expires. (5.2.0) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.2.0)
- Fixes preview errors. (5.1.1) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.1.1)
- Allows use with 10.4 prerelease peers. (5.0.2) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.0.2)
- CSF Next compatibility was added for the definePreview addons pattern. (5.0.1) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v5.0.1)

## @chromatic-com/storybook 4

### Breaking changes

- Access to channel data was restricted. (4.1.4) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v4.1.4)
- The channel fetch relay was removed. (4.1.4) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v4.1.4)

### Behavior and default changes

- Broadened the Storybook peer dependency version range to include 10.1.0-0, allowing the package to be used with that prerelease. (4.1.2) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v4.1.2)

## @chromatic-com/storybook 3

### Breaking changes

- The channel fetch relay was removed and channel data was restricted. (3.2.8) — [release notes](https://github.com/chromaui/addon-visual-tests/releases/tag/v3.2.8)