@tiptap/react
3.34.0 · 13 Nov 2026MIT32.2M / weekRepositoryHomepagenpmAtom feed
211 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 3.x · latest line
3.3.1
2 Sep 2025Prevent incorrect insertion of code marks when a space immediately follows backticks.
Fixed outdated warning message to reference
@tiptap/extension-undo-redoinstead of@tiptap/extension-history.Improve drag handle node lookup by scanning element bounding rects inside the editor instead of performing per-pixel
elementsFromPointloops, and throttle mouse handling to a single update per animation frame to reduce CPU usage and improve stability.This should make drag handle positioning and node detection significantly faster and more robust.
Releases
@tiptap/extension-code@3.3.1
Patch Changes
Prevent incorrect insertion of code marks when a space immediately follows backticks.
@tiptap/extension-collaboration@3.3.1
Patch Changes
Fixed outdated warning message to reference
@tiptap/extension-undo-redoinstead of@tiptap/extension-history.
@tiptap/extension-drag-handle@3.3.1
Patch Changes
Improve drag handle node lookup by scanning element bounding rects inside the editor instead of performing per-pixel
elementsFromPointloops, and throttle mouse handling to a single update per animation frame to reduce CPU usage and improve stability.This should make drag handle positioning and node detection significantly faster and more robust.
@tiptap/extension-emoji@3.3.1
Patch Changes
Preserve 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.
Patch Changes
Fix collaboration extension selection to use the extension with a provider instead of the first registered extension
3.3.0
23 Aug 2025Ensure
ReactRenderer.destroy()removes the renderer DOM element when present.
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/pm 3.2.0
3.1.0
10 Aug 2025Expose
onDragStartandonDragEndcallbacks to improve custom drag behavior. This allows better UI control compared to relying oneditor.view.dragging, especially when using absolute-positioned drag handles.Expose
onDragStartandonDragEndcallbacks to improve custom drag behavior. This allows better UI control compared to relying oneditor.view.dragging, especially when using absolute-positioned drag handles.Fixed bubble menus having invalid positions on node selections
Releases
@tiptap/extension-drag-handle@3.1.0
Minor Changes
Expose
onDragStartandonDragEndcallbacks to improve custom drag behavior. This allows better UI control compared to relying oneditor.view.dragging, especially when using absolute-positioned drag handles.
@tiptap/extension-drag-handle-react@3.1.0
Minor Changes
Expose
onDragStartandonDragEndcallbacks to improve custom drag behavior. This allows better UI control compared to relying oneditor.view.dragging, especially when using absolute-positioned drag handles.
@tiptap/extension-bubble-menu@3.1.0
Patch Changes
Fixed bubble menus having invalid positions on node selections
@tiptap/extension-emoji@3.1.0
Patch Changes
Fixed a problem where the emoji extension would interfer with editor's in composing mode (for example in IME conversion)
@tiptap/extension-mathematics@3.1.0
Patch Changes
Fixed an issue with the mathematics regex using modern negative lookups causing crashes in older Safari versions.
@tiptap/static-renderer@3.1.0
Patch Changes
Fixed a bug causing invalid number of columns being created while converting tables to Markdown
Fixed an issue preventing overriding the default options of the static renderer's
renderToMarkdownfunction.
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 2025- Breaking
Switched to tsup for bundling — UMD builds are no longer supported. If you rely on UMD, you'll need to re-bundle manually.
- Breaking
Replaced Tippy.js with Floating UI — Affects all menu-related extensions (
FloatingMenu,BubbleMenu,Mention,Suggestion, etc.). MarkViews — You can now build custom views for marks (similar to NodeViews), including full support for React and Vue 3 components.
@tiptap/react
Major Changes
- Breaking
Switched to tsup for bundling — UMD builds are no longer supported. If you rely on UMD, you'll need to re-bundle manually.
- Breaking
Replaced Tippy.js with Floating UI — Affects all menu-related extensions (
FloatingMenu,BubbleMenu,Mention,Suggestion, etc.).This is a breaking change and requires a manual migration.
tippyOptionshas been removed and replaced with a newoptionsprop.You must install
@floating-ui/dom@^1.6.0as a peer dependency.Refer to the docs for updated usage:
New Features & Improvements
MarkViews — You can now build custom views for marks (similar to NodeViews), including full support for React and Vue 3 components.
Error thrown in development mode if
immediatelyRenderis missing in SSR mode — Helps catch SSR issues early.Added support for React 19
refbehavior — Improves compatibility with upcoming React features.Reintroduced
flushSync— Ensures updates between React and ProseMirror stay in sync.
Fixes & Enhancements
BubbleMenu positioning fixes — BubbleMenu now correctly tracks table cell selections.
Ref cleanup — Fixed memory leaks and behavior issues by properly cleaning up
refprops and event listeners.Allow custom tags for
MarkViewContentviaasprop.Fixed DOM attachment issues in
NodeViewandMarkView.Improved MarkView support for live attribute updates (
updateAttributesnow supported).Various bugfixes, including:
Global resize handler not unregistered on destroy
Invalid ref props passed to unsupported components
Table-related selection bugs
Rendering issues in SSR mode
3.0.0
14 Jul 2024- 2.x
2.25.0
6 Jul 2025Reintroduce flushSync to sync rendering of React and ProseMirror
@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 2025Only updates dependencies:@tiptap/extension-floating-menu 2.24.1@tiptap/extension-bubble-menu 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
@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
2.22.0 – 2.23.16 releases that only update dependencies@tiptap/extension-bubble-menu 2.23.1@tiptap/extension-floating-menu 2.23.1Show each
- 2.23.130 Jun 2025@tiptap/extension-bubble-menu 2.23.1@tiptap/extension-floating-menu 2.23.1
- 2.23.026 Jun 2025@tiptap/extension-bubble-menu 2.23.0@tiptap/extension-floating-menu 2.23.0
- 2.22.321 Jun 2025@tiptap/extension-bubble-menu 2.22.3@tiptap/extension-floating-menu 2.22.3
- 2.22.221 Jun 2025@tiptap/extension-bubble-menu 2.22.2@tiptap/extension-floating-menu 2.22.2
- 2.22.121 Jun 2025@tiptap/extension-bubble-menu 2.22.1@tiptap/extension-floating-menu 2.22.1
- 2.22.020 Jun 2025@tiptap/extension-bubble-menu 2.22.0@tiptap/extension-floating-menu 2.22.0
2.14.1
19 Jun 2025Fixed a bug that incorrectly added ref props when a component can't accept them (for example when React 19 is not used)
Fixes an issue where ref props will be kept on non-supported react components
2.14.0
6 Jun 2025Only updates dependencies:@tiptap/extension-bubble-menu 2.14.0@tiptap/extension-floating-menu 2.14.0
2.13.0
5 Jun 2025Added support for React 19 ref in props
@tiptap/react@2.13.0
Minor Changes
Added support for React 19 ref in props
2.12.0
5 May 2025Update prosemirror-changeset library to support token encoders
2.11.9
30 Apr 2025Only updates dependencies:@tiptap/extension-bubble-menu 2.11.9@tiptap/extension-floating-menu 2.11.9
2.11.7
30 Mar 2025Clone dragged node before dragging to get correct drag preview image
Added new export for TableView class
2.11.6
28 Mar 2025Only updates dependencies:@tiptap/extension-bubble-menu 2.11.6@tiptap/extension-floating-menu 2.11.6
2.11.5
31 Jan 2025Upgraded prosemirror-tables to 1.6.3 to fix cells being resizable while the editor is uneditable
2.11.4
30 Jan 20252.11.2
10 Jan 20252.11.1
10 Jan 2025Update LICENSE.md, fix copyright license year
handleSelectionUpdate callback is triggered before the renderer is initialized.
Add missing node view props to props type object
What's Changed
Update LICENSE.md, fix copyright license year
handleSelectionUpdate callback is triggered before the renderer is initialized.
Add missing node view props to props type object
extension-link: Fix the issue where a link cannot be pasted when…
core: Convert class attribute to string
Publish a new pre-release version
2.11.0
30 Dec 2024link: Change type HTMLLinkElement to HTMLAnchorElement
#5851 - While setting content directly while using CharacterCount with limit is not obeyed
Prevent selection deletions at the end of list items from joining lists
What's Changed
link: Change type HTMLLinkElement to HTMLAnchorElement
#5851 - While setting content directly while using CharacterCount with limit is not obeyed
Prevent selection deletions at the end of list items from joining lists
Fix inline code formatting for text enclosed in backticks
Font family extesion demo
Remove unused spec for font family extension
Extension link object replacement caracter sanitization
Fix headline rules ignoring level 1 headlines
Allow support for drag-and-drop between multiple editors
Fix emptyTextBlock detection to handle leaf nodes too
Fix losing text selection/focus briefly when using the
focuscommand on AndroidAllow suggestion character to be used inside the suggestion query
Fixing select-all command
Fix : React DND broken when used within a NodeViewWrapper
Force add text align styles when a defaultAlignment is set
Remove empty text style handling
"fix: remove empty text style handling"
text-style: To fix Nested marks with styling are stripped by default #5720
Replaced youtube regex with regex found on regexr.com/3dj5t, …
extension-code: Support safari versions 16.4 and older
Fix/remove empty text style extension
Update linkifyjs to support object-replacement characters
task-item: Fix updating checked status
core: Add
rewriteUnknownContentutility for cleaning JSONPublish a new pre-release version
2.10.4
19 Dec 2024- Security
Fixed Link extension's commands not respecting XSS prevention via unallowed protocols
Publish a new stable 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.