# What changed in @tiptap/extension-bubble-menu

> 11 changes in @tiptap/extension-bubble-menu 2 to 3 from its official release notes, upgrade guides and advisories: 4 breaking, 1 new APIs and options. Each one cited. Sources checked 2026-11-12. HTML: https://unstale.sh/npm/@tiptap/extension-bubble-menu/

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

## @tiptap/extension-bubble-menu 3

### New APIs and options

- New transaction meta handlers let developers programmatically show and hide floating and bubble menus. (3.22.2) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-bubble-menu/CHANGELOG.md#3222)

### Fixes and other changes

- Positioning now runs only for menus that are already shown, preventing hidden bubble menus from reappearing during scroll and resize updates. (3.22.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-bubble-menu/CHANGELOG.md#3220)
- BubbleMenu and FloatingMenu use pluginKey as the transaction meta key, allowing multiple instances to be updated independently. (3.20.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-bubble-menu/CHANGELOG.md#3200)
- BubbleMenu props now update after initialization. (3.18.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-bubble-menu/CHANGELOG.md#3180)
- FloatingMenu props now update after initialization. (3.18.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-bubble-menu/CHANGELOG.md#3180)
- Bubble and floating menus now handle hide middleware data correctly, hiding when the reference element is scrolled out of view. (3.17.1) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-bubble-menu/CHANGELOG.md#3171)
- Avoids throwing a TypeError when the editor is being destroyed. (3.17.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-bubble-menu/CHANGELOG.md#3170)

## @tiptap/extension-bubble-menu 2

### Breaking changes

- Bubble menus now use Floating UI instead of Tippy.js, so migrate menu positioning and behavior to Floating UI options. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- Install this required dependency for bubble and floating menus. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- Use the options prop for Floating UI configuration in place of tippyOptions. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- Import the React BubbleMenu from the /menus entry point instead of @tiptap/react. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)