unstale

npm / @tiptap/extension-bubble-menu

@tiptap/extension-bubble-menu

What changed in @tiptap/extension-bubble-menu 2 to 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-12.

4 breaking1 new APIs and options6 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.12 on npm

@tiptap/extension-bubble-menu 37 changes

New APIs and options 1

  • New transaction meta handlers let developers programmatically show and hide floating and bubble menus.

    3.22.2release notes

Fixes and other changes 6

  • Positioning now runs only for menus that are already shown, preventing hidden bubble menus from reappearing during scroll and resize updates.

    3.22.0release notes

  • BubbleMenu and FloatingMenu use pluginKey as the transaction meta key, allowing multiple instances to be updated independently.

    3.20.0release notes

  • BubbleMenu props now update after initialization.

    3.18.0release notes

  • FloatingMenu props now update after initialization.

    3.18.0release notes

  • Bubble and floating menus now handle hide middleware data correctly, hiding when the reference element is scrolled out of view.

    3.17.1release notes

  • Avoids throwing a TypeError when the editor is being destroyed.

    3.17.0release notes

@tiptap/extension-bubble-menu 24 changes

Breaking changes 4

  • Bubble menus now use Floating UI instead of Tippy.js, so migrate menu positioning and behavior to Floating UI options.

    2.0.0upgrade guide

  • Install this required dependency for bubble and floating menus.

    2.0.0upgrade guide

  • Use the options prop for Floating UI configuration in place of tippyOptions.

    2.0.0upgrade guide

  • Import the React BubbleMenu from the /menus entry point instead of @tiptap/react.

    2.0.0upgrade guide