# What changed in @tiptap/suggestion

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

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

## @tiptap/suggestion 3

### New APIs and options

- Adds a configuration option for dismissing managed suggestion popups when a click occurs outside both the popup and editor; enabled by default for popups mounted via props.mount. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3270)
- Adds initialItems as part of async suggestion lifecycle handling. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3270)
- Adds a loading state as part of async suggestion lifecycle handling. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3270)
- Adds a minQueryLength filter as part of async suggestion lifecycle handling. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3270)
- Adds props.mount(element) to mount and automatically position a popup, returning an unmount function; manual positioning remains supported. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3270)
- Exposes placement, offset, flip, container, and resolved floatingUi configuration so consumers can drive their own positioning loop. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3270)
- Adds a callback to filter when suggestions are displayed, useful in collaborative environments to prevent suggestions from opening for remote users. (3.15.1) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3151)

### Behavior and default changes

- Supports debounced asynchronous suggestion items and aborts in-flight requests. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3270)

### 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/suggestion/CHANGELOG.md#3224)
- Suggestions dismissed via Escape no longer reappear while the user keeps typing in the same word; they return after whitespace, a newline, or moving the cursor to a different trigger. (3.22.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/suggestion/CHANGELOG.md#3220)

## @tiptap/suggestion 2

### Breaking changes

- Install this required dependency for the Floating UI replacement affecting @tiptap/suggestion. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)
- Suggestion replaces Tippy.js with Floating UI for floating elements, so integrations relying on Tippy.js need to migrate. (2.0.0) — [upgrade guide](https://tiptap.dev/docs/guides/upgrade-tiptap-v2)