@tiptap/extension-emoji
3.34.0 · 13 Nov 2026MIT733.5k / weekRepositoryHomepagenpmAtom feed
134 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 3.x · latest line
3.3.1
2 Sep 2025Preserve prefixes when replacing emoji shortcodes to avoid unintended conversions.
Previously, shortcodes such as
:x:could be converted into emoji nodes even when part of a larger string (e.g., in URLs or other text). The paste handler now preserves prefixes, which helps prevent unwanted conversions in such cases, but does not specifically target URLs.Fix collaboration extension selection to use the extension with a provider instead of the first registered extension
3.3.0
23 Aug 2025Make input rules and paste rules respect extension
priorityby registering
them per-extension instead of aggregating them into a single global plugin.Fix paste rule handling for node views and defensively guard empty ranges.
This patch ensures paste rules can correctly inspect node content when
node-specific size metadata (nodeSize) is present, falling back tonode.content.sizewhen needed. It also skips empty or invalid node ranges
before callingtextBetween, preventing runtime errors originating from
internal Fragment/Node traversals (for example: "Cannot read properties of
undefined (reading 'nodeSize')").Change the
generateIDoption to accept a context object:{ node, pos }.This lets ID generators access both the ProseMirror
nodeand itsposwithin the document when creating IDs, enabling logic that depends on node content, type, or position.The change is backwards-compatible: existing
generateIDfunctions that ignore the new context will continue to work. Example usage:editor.use(UniqueID, { generateID: ({ node, pos }) => `${node.type.name}-${pos}-${uuidv4()}`, })
Releases
@tiptap/core@3.3.0
Minor Changes
Make input rules and paste rules respect extension
priorityby registering
them per-extension instead of aggregating them into a single global plugin.
Why
Previously all `addInputRules()` and `addPasteRules()` were gathered into one global plugin which ran before the other plugins. That caused conflicts where some extensions (for example mention/suggestion with `#`) could not preempt the built-in heading input rule.
What changed
- Input and paste rules are now created and registered at the position of the owning extension. This makes their execution order follow the extension sorting/`priority` mechanism. - Behavior is more predictable: extensions with higher `priority` can now take precedence over lower priority extensions' input/paste rules.Migration & compatibility
- This is a behavioral change. If you relied on the old global ordering (input rules always running before other plugins), you may observe different outcomes. In most cases this is desirable and fixes conflicts (like the `#` mention vs. heading shortcut), but be aware of the change. - If you need to force the previous behavior for a specific rule, you can: - Register the rule as a ProseMirror plugin via `addProseMirrorPlugins()` on the extension and place it where you want it to run. - Adjust the extension `priority` value so the extension sits earlier or later in the ordering. If you have any questions or see regressions after upgrading, please open an issue with a small repro and we'll help triage.Patch Changes
Fix paste rule handling for node views and defensively guard empty ranges.
This patch ensures paste rules can correctly inspect node content when
node-specific size metadata (nodeSize) is present, falling back tonode.content.sizewhen needed. It also skips empty or invalid node ranges
before callingtextBetween, preventing runtime errors originating from
internal Fragment/Node traversals (for example: "Cannot read properties of
undefined (reading 'nodeSize')").
@tiptap/extension-unique-id@3.3.0
Patch Changes
Change the
generateIDoption to accept a context object:{ node, pos }.This lets ID generators access both the ProseMirror
nodeand itsposwithin the document when creating IDs, enabling logic that depends on node content, type, or position.The change is backwards-compatible: existing
generateIDfunctions that ignore the new context will continue to work. Example usage:editor.use(UniqueID, { generateID: ({ node, pos }) => `${node.type.name}-${pos}-${uuidv4()}`, })
@tiptap/react@3.3.0
Patch Changes
Ensure
ReactRenderer.destroy()removes the renderer DOM element when present.When consumers append a
ReactRenderer's.elementto the DOM (for example many demos append it todocument.body), previously callingdestroy()removed the portal renderer but left the DOM node in place which could lead to accumulating.react-rendererelements.destroy()now also removes the element from its parent node if present, preventing leaked DOM nodes / React roots.
@tiptap/suggestion@3.3.0
Patch Changes
Add a safe API to exit suggestions and remove decorations.
Dispatching a metadata-only transaction with
{ exit: true }will now reliably deactivate the suggestion plugin and remove inline decorations.Pressing Escape now triggers renderer.onExit and dispatches the exit meta, so suggestions close immediately without needing document edits.
Clicking outside the editor will also close active suggestions.
Exported
exitSuggestion(view, pluginKey?)helper to programmatically close suggestions safely.
3.2.2
22 Aug 2025Change the
generateIDoption to accept a context object:{ node, pos }.This lets ID generators access both the ProseMirror
nodeand itsposwithin the document when creating IDs, enabling logic that depends on node content, type, or position.
3.2.1
21 Aug 2025Ensure drag previews for node views work correctly in Safari by attaching
an offscreen clone of the node to the DOM while callingsetDragImage, and by preserving the original element's pixelwidth/heightso the preview matches the original. This prevents
Safari from immediately cancelling the drag when a detached element is
used as the drag image.
3.2.0
14 Aug 2025Only updates dependencies:@tiptap/core 3.2.0@tiptap/suggestion 3.2.0@tiptap/pm 3.2.0
3.1.0
10 Aug 2025Fixed a problem where the emoji extension would interfer with editor's in composing mode (for example in IME conversion)
3.0.9
1 Aug 2025Fixed the Vue 3 Drag Handle so it only appears when the user starts interacting with the text editor.
Update TaskItem aria-label when node changes
Fix renderToMarkdown rendering a link href's as undefined
3.0.8
1 Aug 2025- Security
Bump linkifyjs version to latest to address the recently discovered prototype pollution vulnerability
3.0.7
16 Jul 2025Fix a problem with the inline option and virtual elements missing getClientRects
Fix a problem with the inline option and virtual elements missing getClientRects
3.0.6
15 Jul 2025Broken types for function chaining when calling extend
3.0.5
15 Jul 2025Only updates dependencies:@tiptap/extension-bubble-menu 3.0.5@tiptap/extension-floating-menu 3.0.5
3.0.4
15 Jul 2025Add correct overload for extension extend types
3.0.3
15 Jul 2025Avoid the JSX Runtime to globally overwrite React's Element types when
/** @jsxImportSource @tiptap/core */is not used
Releases
@tiptap/core@3.0.3
Patch Changes
Avoid the JSX Runtime to globally overwrite React's Element types when
/** @jsxImportSource @tiptap/core */is not used
@tiptap/extension-blockquote@3.0.3
@tiptap/extension-bold@3.0.3
3.0.2
15 Jul 2025Correctly pass through the bubble menu floating options
Improvement: Added better JSDocs for the options object
Improvement: Added better JSDocs for the options object
3.0.1
12 Jul 2025The StarterKit extension now includes more extensions by deafult
The Table, Details and List extensions now include all their sub-packages. The Table and List extensions also export new Kit extensions to quickly register all of them in one go.
Tiptap 3.0.0 Stable
This is the stable release for 3.0.0. Since we accidentially released our 3.0.0 last year and had to deprecate it, we're moving forward with 3.0.1 as our initial release for this major cycle.
Since our auto-generated changelog was to big for Github to handle we have to write this manually. Yikes!
Other changes
Since listing all changes here manually would be again to big for Github's editor we would like you to take a look into the package's
CHANGELOG.mdwhere you can find ALL changes made on each version including all pre-releases prior to the official stable release.Also take a look at our upgrade guide where you can find out what changed on all meta packages, how to upgrade to V3, etc.
The StarterKit extension now includes more extensions by deafult
The Table, Details and List extensions now include all their sub-packages. The Table and List extensions also export new Kit extensions to quickly register all of them in one go.
What now?
We'll continue working on this release, quickly hotfix the bugs encountered by the community and make 3.0.0 even better. We'll also look into new features like Markdown Support, Migrations and the Decoration API for our upcoming minor releases.
4.0.0 will not be far away - if we do breaking changes in the following weeks you'll see it in the coming weeks/months.
Contribute
Feel free to contribute to Tiptap in form of reporting issues, answering questions, helping with the CI, with tests or taking on Issues on your own. We're super happy for every contribution you make 💕.
- 2.x
2.25.0
6 Jul 2025Reintroduce flushSync to sync rendering of React and ProseMirror
Releases
@tiptap/react@2.25.0
Minor Changes
Reintroduce flushSync to sync rendering of React and ProseMirror
2.24.2
4 Jul 2025Added alt tag to emoji extension
2.24.1
3 Jul 2025Added
tab-index="0"to bubble and floating menu wrappers"Added
tab-index="0"to bubble and floating menu wrappers"Added a new
a11yoption to task list items to set the checkbox aria-label
Releases
@tiptap/extension-bubble-menu@2.24.1
Patch Changes
Added
tab-index="0"to bubble and floating menu wrappers"
@tiptap/extension-floating-menu@2.24.1
Patch Changes
Added
tab-index="0"to bubble and floating menu wrappers"
@tiptap/extension-task-item@2.24.1
Patch Changes
Added a new
a11yoption to task list items to set the checkbox aria-label
@tiptap/react@2.24.1
@tiptap/starter-kit@2.24.1
@tiptap/vue-2@2.24.1
@tiptap/vue-3@2.24.1
2.24.0
2 Jul 2025Removed flushSync on NodeView render which caused performance regressions, bugs with unused NodeViews still being reconciled for PMViewDesc checks and more
Fix RangeException in cut command when targetPos is zero
Fix autolink option in shadow dom by extending the whitespace detection to more unicode characters
Releases
@tiptap/react@2.24.0
Minor Changes
Removed flushSync on NodeView render which caused performance regressions, bugs with unused NodeViews still being reconciled for PMViewDesc checks and more
@tiptap/core@2.24.0
Patch Changes
Fix RangeException in cut command when targetPos is zero
@tiptap/extension-link@2.24.0
Patch Changes
Fix autolink option in shadow dom by extending the whitespace detection to more unicode characters
@tiptap/starter-kit@2.24.0
@tiptap/vue-2@2.24.0
@tiptap/vue-3@2.24.0
2.23.1
30 Jun 2025Fix a bug that causes rerenders on the react drag handle breaking its tippy connection
Show mention indicator when converting document to HTML
Releases
@tiptap/extension-drag-handle-react@2.23.1
Patch Changes
Fix a bug that causes rerenders on the react drag handle breaking its tippy connection
@tiptap/extension-mention@2.23.1
Patch Changes
Show mention indicator when converting document to HTML
@tiptap/react@2.23.1
@tiptap/starter-kit@2.23.1
@tiptap/vue-2@2.23.1
@tiptap/vue-3@2.23.1
2.23.0
26 Jun 2025Support multiple triggers in Mention extension
Prevent content deletion from non-editable Tiptap source editors during drag and drop.
Releases
@tiptap/extension-mention@2.23.0
Minor Changes
Support multiple triggers in Mention extension
@tiptap/core@2.23.0
Patch Changes
Prevent content deletion from non-editable Tiptap source editors during drag and drop.
@tiptap/react@2.23.0
@tiptap/starter-kit@2.23.0
@tiptap/vue-2@2.23.0
@tiptap/vue-3@2.23.0
2.22.3
21 Jun 2025Added new
canInsertNodeutility that checks if a node can be inserted into a specific positionFixed a bug that caused the horizontal rule's
setHorizontalRulecommand to always return true when checked viacan()
Releases
@tiptap/core@2.22.3
Patch Changes
Added new
canInsertNodeutility that checks if a node can be inserted into a specific position
@tiptap/extension-horizontal-rule@2.22.3
Patch Changes
Fixed a bug that caused the horizontal rule's
setHorizontalRulecommand to always return true when checked viacan()
@tiptap/react@2.22.3
@tiptap/starter-kit@2.22.3
@tiptap/vue-2@2.22.3
@tiptap/vue-3@2.22.3
2.22.2
21 Jun 2025Add validation for target position within document range when trying to access children of a
NodePosinstance
Releases
@tiptap/core@2.22.2
Patch Changes
Add validation for target position within document range when trying to access children of a
NodePosinstance
@tiptap/react@2.22.2
@tiptap/starter-kit@2.22.2
@tiptap/vue-2@2.22.2
@tiptap/vue-3@2.22.2
2.22.0
20 Jun 2025We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.