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

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

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

## @tiptap/extension-floating-menu 3

### New APIs and options

- New transaction meta handlers let developers programmatically show or hide the floating and bubble menus using the show and hide values. (3.22.2) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-floating-menu/CHANGELOG.md#3222)
- FloatingMenu supports programmatic position updates via setMeta('floatingMenu', 'updatePosition'). (3.16.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-floating-menu/CHANGELOG.md#3160)

### Fixes and other changes

- Fixes peer dependency resolution conflicts when installing dependencies after package updates. (3.22.4) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-floating-menu/CHANGELOG.md#3224)
- 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-floating-menu/CHANGELOG.md#3200)
- FloatingMenu props now update after initialization. (3.18.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-floating-menu/CHANGELOG.md#3180)
- Bubble and floating menus now handle hide middleware data correctly, hiding menus when the reference element is scrolled out of view. (3.17.1) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-floating-menu/CHANGELOG.md#3171)

## @tiptap/extension-floating-menu 2

### Breaking changes

- This becomes a required dependency for floating menus. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- Floating menus use Floating UI options instead of Tippy.js options, allowing configuration such as offset and placement. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- React menu imports move to the `/menus` entry point. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- Vue 2 menu imports move to the `/menus` entry point. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- Vue 3 menu imports move to the `/menus` entry point. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)