# What changed in @storybook/addon-essentials

> 95 changes in @storybook/addon-essentials 7 to 8 from its official release notes, upgrade guides and advisories: 71 breaking, 18 deprecations, 2 new APIs and options. Each one cited. Sources checked 2026-10-27. HTML: https://unstale.sh/npm/@storybook/addon-essentials/

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

## @storybook/addon-essentials 8

### Breaking changes

- AddonStore addPanel is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook now requires Angular 15 or higher. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The ArgsTable Doc block is removed in favor of ArgTypes and Controls. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Webpack 5-based Web Components projects no longer receive @babel/preset-env by default and instead use their included configuration. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Canvas Doc block children property is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Canvas Doc block columns property is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Canvas Doc block isColumn property is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Canvas Doc block mdxSource property is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Canvas Doc block withSource property is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The WithTooltipComponent property is removed; use closeOnOutsideClick instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The React type is removed in favor of StoryFn, StoryObj, and Meta. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The React type is removed in favor of StoryFn, StoryObj, and Meta. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The React type is removed in favor of StoryFn, StoryObj, and Meta. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The React type is removed in favor of StoryFn, StoryObj, and Meta. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The deprecated config preset field is removed; use previewAnnotations instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The APIs from @storybook/channel-websocket and @storybook/postmessage are removed; use createBrowserChannel from @storybook/channels. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The DecoratorFn type is removed in favor of Decorator. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook no longer adds default Babel plugins for Preact Webpack projects; add the JSX transform plugin and TypeScript preset to Babel configuration if needed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Default keyboard shortcuts changed to avoid conflicts with browser shortcuts and typing in the Manager. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The children, markdown, and type properties are removed in favor of the of property. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The feature flag was renamed to experimentalRSC to support RSC in non-Next.js frameworks. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- AddonStore getServerChannel is removed; use getChannel instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- AddonStore hasServerChannel is removed; use hasChannel instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The addon controls parameter has been removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The hideOnly prop has been removed from @storybook/router's Route; implement the behavior manually with Match if needed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Action spies are no longer inferred from onX props or actions.argTypesRegex. Add spies explicitly with fn() from @storybook/test. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The jsxOptions configuration was removed because it is no longer used. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The toolbar item left property is replaced by icon for positioning its content. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Remove the legacyMdx1 main.js feature flag when migrating from the legacy MDX1 format. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Addon UI is now rendered with React 18; the key prop is no longer passed to the render function. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook now uses MDX3 under the hood; MDX3 includes improvements and small breaking changes. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The manager-api method is removed in favor of changeSettingsTab. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook now requires Next.js 13.5 or higher. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The parameter was renamed to react.rsc. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The WithTooltipComponent property is removed; use onVisibleChange instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The docs parameter is removed; use docs.story.iframeHeight instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The docs parameter is removed; use docs.story.inline instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The parameter is removed; use parameters.docs.source.transform instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The parameter is removed; use parameters.docs.source.transform instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The parameter is removed; use parameters.docs.source.transform instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- This option is removed; story functions always receive args first and context second. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The type is removed in favor of PostMessageTransport. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook now requires Preact 10 or higher. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Primary Doc block name prop is removed in favor of of. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Framework TypeScript types are removed in favor of corresponding Renderer types. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The command to generate a .babelrc file for Storybook has been removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- AddonStore serverChannel is removed; use channel instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The @storybook/react export is removed in favor of setProjectAnnotations. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- AddonStore setServerChannel is removed; use setChannel instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Source Doc block id property is removed in favor of of. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Source Doc block ids property is removed in favor of of. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- storybook build no longer generates stories.json by default; index.json remains available. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook no longer supports .stories.mdx files that combine documentation and story definitions; migration scripts are provided for the new format. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Story type is removed in favor of StoryFn and StoryObj. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Story block no longer supports referencing stories by id, name, or story. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Story Doc block story prop is removed in favor of of. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Direct React component imports of LinkTo from this package are removed; import it from @storybook/addon-links/react. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The package and its utilities for programmatically modifying user configuration files during install have been removed; addons that used it must adapt the old source. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The type is removed in favor of StorybookConfig. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The main.js configuration property is removed in favor of experimental_indexers. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook now requires Svelte 4 or higher. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The WithTooltipComponent property is removed; use defaultVisible instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- TAB addons should no longer specify match; Storybook shows their rendered content when the tab query parameter matches the addon ID. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- TAB addons should no longer specify route; Storybook shows their rendered content when the tab query parameter matches the addon ID. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- React component analysis now defaults to react-docgen; set this option to react-docgen-typescript for its full fidelity. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The CLI flag is removed; use --package-manager=npm instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The useAddonState export from @storybook/preview-api is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The useSharedState export from @storybook/preview-api is removed. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook now requires Vue 3 or higher. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook is compiler-agnostic and does not depend on Babel or SWC when using Webpack 5. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)

### Deprecations

- A new Button component is available for use in all places; addon creators and Storybook maintainers should use it instead of Form.Button. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button containsIcon prop is deprecated; add the icon as a child instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Form.Button is deprecated in favor of the new Button component. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button gray prop is deprecated; use variant instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Icons component in @storybook/components is deprecated in favor of @storybook/icons. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button inForm prop is deprecated; use variant instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button isLink prop is deprecated; use asChild instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button outline prop is deprecated; use variant instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button primary prop is deprecated; use variant instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button secondary prop is deprecated; use variant instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button small prop is deprecated; use size instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The StoryStore method is deprecated; use preview.loadStory({ storyId }) after awaiting preview.ready(). (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The StoryStore method is deprecated; use preview.extract() after awaiting preview.ready(). (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- A new icon library is available; addon creators and Storybook maintainers are advised to use it instead of the deprecated Icons component. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The StoryStore global is deprecated and will no longer be accessible in Storybook 9.0. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- The Button tertiary prop is deprecated; use variant instead. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)

### New APIs and options

- Tool addon match functions receive tabId to filter visibility; it is undefined when the canvas is shown. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)

### Behavior and default changes

- IconButton now uses Button under the hood, so its props match Button's props. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Preview.extract() no longer loads CSF files in batches; the former batching workaround slowed extraction and its removal should not affect behavior. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)
- Storybook uses SWC with Next.js 14 or higher when no .babelrc exists, or when experimental.forceSwcTransforms is true. (8.0.0) — [upgrade guide](https://github.com/storybookjs/storybook/blob/HEAD/MIGRATION.md)

## @storybook/addon-essentials 7

### Breaking changes

- A codemod migrates deprecated story types in matching story files after upgrading. (7.0.0) — [upgrade guide](https://storybook.js.org/blog/improved-type-safety-in-storybook-7/)

### Deprecations

- The React-specific utility is deprecated in favor of the new syntax that works across supported frameworks. (7.0.0) — [upgrade guide](https://storybook.js.org/blog/improved-type-safety-in-storybook-7/)
- The React-specific utility is deprecated in favor of the new syntax that works across supported frameworks. (7.0.0) — [upgrade guide](https://storybook.js.org/blog/improved-type-safety-in-storybook-7/)

### New APIs and options

- A new type for CSF3 stories automatically infers component props; passing typeof meta also links meta-level and story-level args. (7.0.0) — [upgrade guide](https://storybook.js.org/blog/improved-type-safety-in-storybook-7/)

### Tooling

- Using CSF3 with TypeScript 4.9+ satisfies enables stricter checking, including warnings for missing required args and safer sharing of play functions. (7.0.0) — [upgrade guide](https://storybook.js.org/blog/improved-type-safety-in-storybook-7/)