@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.34.0
13 Nov 2026getEditorContextnow describes the charts and diagrams of@tiptap-pro/extension-diagrams, so the AI can read, add and change them.Fix Backspace undo after automatic formatting when used with extensions such as UniqueID.
Correct
setContentdocumentation
@tiptap/ai-toolkit
Minor Changes
getEditorContextnow describes the charts and diagrams of@tiptap-pro/extension-diagrams, so the AI can read, add and change them.
@tiptap/core
Patch Changes
Fix Backspace undo after automatic formatting when used with extensions such as UniqueID.
Correct
setContentdocumentation
@tiptap/extension-blockquote
Patch Changes
Keep the caret at the join when Backspace merges a paragraph into the blockquote above it.
@tiptap/extension-details
Patch Changes
A Details node created open now stays open when its content changes right after it is created.
@tiptap/extension-drag-handle-react
Patch Changes
Declare
@types/reactas an optional peer dependency so React types resolve under pnpm's global virtual store.
@tiptap/extension-find-and-replace
Minor Changes
Added a
continuesNodeoption. Textblocks it marks as continuing the textblock before them are searched as one text, so a phrase that runs from one into the next is found, highlighted and replaced.
@tiptap/static-renderer
Patch Changes
Fix React type resolution when using pnpm’s global virtual store.
3.33.1
10 Nov 2026Deleting a text selection that spans the whole document no longer leaves the deleted text's marks active, so text typed into the emptied editor is no longer bold, linked or otherwise marked.
The first
goToNextResult()orgoToPreviousResult()after a new search now selects the highlighted first result instead of skipping it.yCursorPluginnow publishes alastSelectionawareness field with each collaborative field's latest selection and whether its editor is focused. Unlikecursor, it stays after the editor loses focus, so other clients can still read the selection.lastSelectionis now reserved and can't be used as the cursor field.
3.33.0
5 Nov 2026With
enableContentCheck: true, shared content that does not fit the editor schema now emitscontentErrorinstead of being deleted. The editor pauses editing and sends no changes until compatible content arrives, so read-only users no longer send repairs that the server rejects.If you use
enableContentCheckwith collaboration and want the editor to keep repairing invalid content, turn the content check off.Add the
onInvalidContentsync option. When it is set, shared content that does not fit the editor schema stays in the shared document instead of being deleted. The editor shows what it can, pauses editing and sends no changes until compatible content arrives.
3.32.3
5 Nov 2026Fix a React warning when a command like
setContentcreates React node views from inside an effect.Fixed the cursor no longer following clicks after an editor inside a shadow root was unmounted and remounted.
3.32.0
13 Oct 2026Fix
useEditorStateoverflowing the stack when a selector returns a value with circular references, such aseditor.stateafter one stored mark replaces another.
3.31.4
30 Sep 2026Fix Enter and Shift-Enter inside React node views on iOS and Android.
React and Vue now use matching menu extension versions when installed from a specific release.
3.31.3
4 Sep 2026Fix a TypeScript error (TS2694) in the shipped type declarations when
skipLibCheckis turned off.
3.31.2
3 Sep 20263.31.1
3 Sep 2026Fix freezes in framework-based node views on iOS and Android
3.31.0
1 Sep 2026Align
selectedwith ProseMirror node selections by default, expose text selections throughselectionInside, and keepselectedOnTextSelectioncompatible.
3.30.6
31 Aug 2026Reduce overhead in React node views on documents with many nodes.
3.30.5
26 Aug 2026Fix a denial-of-service risk where crafted block or inline Markdown attributes could consume excessive CPU and block the browser or server event loop.
3.30.4
26 Aug 2026Prevent untrusted HTML attributes from changing an object's prototype when merged with
mergeAttributes.
3.30.3
24 Aug 2026Fix ReactNodeViewRenderer crash when contentComponent is not available
3.30.2
18 Aug 2026Keep mixed JSX children as separate siblings in DOM output.
Fixed a bug where
editor.chainandeditor.cancan not be accessed on editor initializationFix resizable images staying hidden when the image is cached or fails to load.
3.30.1
13 Aug 2026Fixed table markdown pipe escaping so the extension loads on older Safari and iOS versions (WebKit before Safari 16.4).
Added new ProseMirror helpers that check whether a value is a specific ProseMirror type.
3.30.0
11 Aug 2026New Decorations API
Finally the decorations API is here! Even though Decorations itself are nothing new in ProseMirror, the new API makes it much easier to use them in Tiptap without leaving your extensions.
Decorations change how the document looks without changing the document itself. Highlighting search results, marking spelling mistakes, showing collaborator cursors, putting a drag handle next to every block.
Until now you had to write a ProseMirror plugin by hand for this, keep the decoration set in plugin state, and map it forward on every transaction. Extensions can now declare decorations directly with a new
addDecorations()hook.addDecorations() { return { create: ({ state }) => // findMatches can be any function that returns an array of { from, to } ranges findMatches(state.doc).map(match => Decoration.Inline(match.from, match.to, { class: 'highlight' }), ), } }There are three kinds.
Decoration.Inline()styles a range of text.Decoration.Node()puts attributes on a block's DOM element.Decoration.Widget()renders your own element at a single position.Every extension that declares decorations is collected into one plugin, so several extensions can decorate the same document without fighting over it.
Doing less work on every keystroke
By default decorations are rebuilt whenever the document changes. That is fine for small documents and wasteful for large ones, so there are two ways to narrow it down.
shouldUpdate()skips transactions you do not care about. If your decorations only depend on headings, ignore everything else.update: 'changedRanges'together withcreateInRange()only rescans the blocks that actually changed. On a long document this is the difference between scanning the whole thing on every keystroke and scanning one paragraph.For decorations driven by data outside the editor, like comments loaded from a server, use
update: 'manual'and refresh them yourself witheditor.commands.updateDecorations().React and Vue components as widgets
ReactWidgetRendererandVueWidgetRendererrender a real component into a widget decoration, inside your existing app context. Providers, context and stores work as usual.Widgets take a
key. Reuse the same key and the component instance stays mounted while the document changes around it, so local state such as an open menu, a counter or a half-typed input survives editing. Use a stable id from your own data, not a position or a list index, otherwise the component remounts and loses that state.Widgets also accept the ProseMirror options
side,relaxedSide,stopEventandignoreSelection.Documentation
React node views no longer show the selected state when the selection covers a position the node view has moved away from.
3.29.2
28 Jul 2026Fixed the caret jumping back to the previous block when pressing Enter inside a React node view.
3.29.1
27 Jul 2026Fix caret placement after splitting a block rendered with a React NodeView.
3.29.0
24 Jul 2026Fixed
useEditorStatenot re-rendering components wheneditor.setEditable()changes the editor's editable state, since that call only emits anupdateevent and never atransaction.
3.28.0
15 Jul 2026Batch React node view portal store notifications that happen in the same microtask to avoid nested update depth warnings when many node views mount together.
Bind onMount and onUnmount event handlers when initializing an Editor with useEditor hook.
@tiptap/react
Patch Changes
Batch React node view portal store notifications that happen in the same microtask to avoid nested update depth warnings when many node views mount together.
Bind onMount and onUnmount event handlers when initializing an Editor with useEditor hook.
3.27.4
13 Jul 2026Add a
use clientdirective so@tiptap/reactcan be imported from React Server Components without crashing. Core symbols re-exported through@tiptap/reactnow cross the client boundary too, so import them from@tiptap/coredirectly in server code.
3.27.3
7 Jul 2026Fix
deleteSelectionto delete content across all selection ranges instead of only the first range. This restores multi-cell table selections and other custom selections with multiple ranges.Fix markdown parsing bugs where block elements right after an ordered list item (with no blank line in between) were wrongly treated as lazy continuation of the list item, instead of terminating the list the way other markdown parsers do:
An indented
***/___inside item content is now also parsed as a horizontal rule inside the item instead of literal text. A---line directly below item paragraph text keeps its current behavior because it is a setext heading underline per CommonMark, not a thematic break.Fix indented ordered list items (e.g. one leading space before the marker, as happens when a top-level ordered list is itself nested inside another list) losing inline formatting during markdown parsing. The custom ordered-list markdown tokenizer built its nested structure with a hardcoded base indentation of 0, so an item whose actual indentation was non-zero never matched, causing the tokenizer to silently produce zero items and bail out — falling back to a path that left the item's content as literal, unparsed text instead of running it through inline tokenization (bold, italic, etc. were lost). The base indentation is now taken from the first collected item instead of being hardcoded.
@tiptap/core
Patch Changes
Fix
deleteSelectionto delete content across all selection ranges instead of only the first range. This restores multi-cell table selections and other custom selections with multiple ranges.
@tiptap/extension-list
Patch Changes
Fix markdown parsing bugs where block elements right after an ordered list item (with no blank line in between) were wrongly treated as lazy continuation of the list item, instead of terminating the list the way other markdown parsers do:
Thematic breaks (
---,***,___,* * *) were swallowed into the list item as literal paragraph text — along with every line after them. They now terminate the list and become a horizontal rule.Fenced code blocks (
```and~~~) were nested inside the list item. They now terminate the list and become a top-level code block.Unindented bullet markers (
- item) were nested inside the ordered list item. They now terminate the ordered list and start a new top-level bullet list. Indented bullets still nest inside the item as before.
An indented
***/___inside item content is now also parsed as a horizontal rule inside the item instead of literal text. A---line directly below item paragraph text keeps its current behavior because it is a setext heading underline per CommonMark, not a thematic break.Fix indented ordered list items (e.g. one leading space before the marker, as happens when a top-level ordered list is itself nested inside another list) losing inline formatting during markdown parsing. The custom ordered-list markdown tokenizer built its nested structure with a hardcoded base indentation of 0, so an item whose actual indentation was non-zero never matched, causing the tokenizer to silently produce zero items and bail out — falling back to a path that left the item's content as literal, unparsed text instead of running it through inline tokenization (bold, italic, etc. were lost). The base indentation is now taken from the first collected item instead of being hardcoded.
@tiptap/extensions
Patch Changes
Fixed placeholder flickering and disappearance on large documents. Replaced the viewport-based decoration scan with an incremental
StateField<DecorationSet>that only re-computes decorations for top-level nodes touched by each transaction. This eliminates the dependency on DOM measurement (posAtCoords),requestAnimationFramescheduling, and scroll listeners that caused flickering under collaboration, occlusion, and rapid edits.
3.27.2
6 Jul 2026Change prop types of the Tiptap component so that either the
editoror theinstancefields are required
@tiptap/react
Patch Changes
Change prop types of the Tiptap component so that either the
editoror theinstancefields are required
3.27.1
18 Jun 2026Respect margin properties passed via
dragImagePropertieson the drag preview. The clone reset its margin to0after copying styles, which discarded any margin the user explicitly requested. The reset now runs only when no margin property is listed indragImageProperties, so the drag image can keep the same spacing as the live block.Fix ordered list parsing so under-indented continuation lines preserve their first character.
Fix Placeholder flickering while a modal overlay is open. When the editor was occluded during a stream of transactions (e.g. remote collaboration edits), the viewport measurement fell back to a full-document range and repeatedly toggled the
data-placeholderattribute on empty blocks. The viewport window is now frozen when the editor can't be measured reliably, so placeholders stay stable.
@tiptap/extension-drag-handle
Patch Changes
Respect margin properties passed via
dragImagePropertieson the drag preview. The clone reset its margin to0after copying styles, which discarded any margin the user explicitly requested. The reset now runs only when no margin property is listed indragImageProperties, so the drag image can keep the same spacing as the live block.
@tiptap/extension-list
Patch Changes
Fix ordered list parsing so under-indented continuation lines preserve their first character.
@tiptap/extensions
Patch Changes
Fix Placeholder flickering while a modal overlay is open. When the editor was occluded during a stream of transactions (e.g. remote collaboration edits), the viewport measurement fell back to a full-document range and repeatedly toggled the
data-placeholderattribute on empty blocks. The viewport window is now frozen when the editor can't be measured reliably, so placeholders stay stable.
3.27.0
17 Jun 2026Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.parseAttributesnow supports any word characters at the start of classes or id attributes.
@tiptap/extension-list
Minor Changes
Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:type="a"→ lowercase alphabetical markerstype="A"→ uppercase alphabetical markerstype="i"→ lowercase roman numeral markerstype="I"→ uppercase roman numeral markers
Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.
@tiptap/core
Patch Changes
Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:type="a"→ lowercase alphabetical markerstype="A"→ uppercase alphabetical markerstype="i"→ lowercase roman numeral markerstype="I"→ uppercase roman numeral markers
Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.parseAttributesnow supports any word characters at the start of classes or id attributes.Fix
marksEqualto compare mark arrays as multisets instead of index-by-index, so order of marks no longer affects the result. Broaden the type signature to accept ProseMirrorMarkobjects (wheretypeis an object with anameproperty) alongside the existing JSON mark shape ({ type: string }).Fix a edge-case in
rewriteUnknownContentto not fail on null-ish values inside marks or nodes.
@tiptap/extension-link
Patch Changes
Fix
isAllowedUriaccepting unknown protocols whose name contains a hyphen (e.g.unknown-protocol://test). The hyphen is a valid scheme character per RFC 3986, but the regex was built from a template literal where\-collapsed to-, leaving the terminator class[^a-z+.-:]to parse.-:as a character range that excluded0-9and/rather than-. With the proper double-escape, the regex correctly excludes-and unknown hyphenated schemes are rejected again.
@tiptap/suggestion
Minor Changes
Add
props.mount(element)for fully managed popup positioning. It mounts the popup into the configuredcontainer(defaultdocument.body), keeps it anchored to the cursor, and automatically repositions on scroll, resize, and layout shifts via Floating UI'sautoUpdate— no manual listeners required. It returns anunmountfunction to call inonExit.This is additive and opt-in: mounting and positioning manually with
props.floatingUi+props.clientRectremains supported as an escape hatch.Dismiss managed suggestion popups when the user clicks outside both the popup and the editor. Enabled by default for popups mounted via
props.mount, and configurable with the newdismissOnOutsideClickoption.Expose Floating UI positioning configuration through
SuggestionProps. Consumers can now readplacement,offset,flip,container, and a resolvedfloatingUiconfig to drive their own positioning loop.Add async suggestion lifecycle handling, including debounced async
items(), in-flight request aborting,initialItems, aloadingstate, and aminQueryLengthfilter.
@tiptap/markdown
Patch Changes
Fix parsing with injected Marked instances so custom markdown tokenizers registered via
marked.use(...)are respected.Fix unrecognized HTML detection during markdown parsing to work without
window.DOMParserorHTMLUnknownElement, so angle-bracket placeholders are preserved as literal text in SSR and Node environments.
@tiptap/extension-drag-handle
Patch Changes
Fix multi-block drags only removing the first block when nested mode is enabled
3.26.1
11 Jun 2026Fixed drag-and-drop duplicating blocks during collaboration. When a remote collaborator edited the document mid-drag, dropping left an empty copy of the dragged block at its original position. This fix also requires a version of
@tiptap/y-tiptapthat restores node range selections across remote updates.Restore the node range selection after dragging multiple blocks. Previously, dropping a multi-block drag left a text selection inside the moved content instead of keeping the dragged blocks selected.
@tiptap/extension-node-range
Patch Changes
Fixed drag-and-drop duplicating blocks during collaboration. When a remote collaborator edited the document mid-drag, dropping left an empty copy of the dragged block at its original position. This fix also requires a version of
@tiptap/y-tiptapthat restores node range selections across remote updates.Bump
@tiptap/y-tiptapto version ^3.0.5
@tiptap/extension-drag-handle
Patch Changes
Restore the node range selection after dragging multiple blocks. Previously, dropping a multi-block drag left a text selection inside the moved content instead of keeping the dragged blocks selected.
Bump
@tiptap/y-tiptapto version ^3.0.5
@tiptap/extension-collaboration-caret
Patch Changes
Bump
@tiptap/y-tiptapto version ^3.0.5
@tiptap/extension-collaboration
Patch Changes
Bump
@tiptap/y-tiptapto version ^3.0.5
3.26.0
5 Jun 2026Backspace at the start of a non-first child of a blockquote now lifts that child out, splitting the blockquote around it. A second backspace at the start of a top-level textblock whose previous sibling is a blockquote merges the textblock's inline content into the blockquote's last textblock instead of pulling the paragraph back inside.
Only add hash attributes to nodes, not to marks.
Fix the
Selectionextension highlighting beyond the selected text on multi-line selections: the native browser selection is now hidden while the editor is blurred, so only the styled.selectiondecoration is shown.
@tiptap/extension-blockquote
Minor Changes
Backspace at the start of a non-first child of a blockquote now lifts that child out, splitting the blockquote around it. A second backspace at the start of a top-level textblock whose previous sibling is a blockquote merges the textblock's inline content into the blockquote's last textblock instead of pulling the paragraph back inside.
@tiptap/server-ai-toolkit
Patch Changes
Only add hash attributes to nodes, not to marks.
@tiptap/extensions
Patch Changes
Fix the
Selectionextension highlighting beyond the selected text on multi-line selections: the native browser selection is now hidden while the editor is blurred, so only the styled.selectiondecoration is shown.
3.25.0
3 Jun 2026Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.Add
clearablemark option (defaulttrue).unsetAllMarksnow skips marks withclearable: false, so semantic marks like comments are not removed by "clear formatting".Add
attrsEqualandmarksEqualutility functions to@tiptap/core.attrsEqualcompares two attribute objects for equality regardless of key ordering.marksEqualcompares two arrays of mark objects by type and attributes usingattrsEqual.
@tiptap/core
Patch Changes
Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.Add
clearablemark option (defaulttrue).unsetAllMarksnow skips marks withclearable: false, so semantic marks like comments are not removed by "clear formatting".Add
attrsEqualandmarksEqualutility functions to@tiptap/core.attrsEqualcompares two attribute objects for equality regardless of key ordering.marksEqualcompares two arrays of mark objects by type and attributes usingattrsEqual.Fix plain-text copy of table cell selections including content from unselected cells in between. Each selected range is now serialized independently and joined in document order, so dragging upward (reverse selection) also produces output in document order.
@tiptap/extension-file-handler
Patch Changes
Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.
@tiptap/extension-image
Patch Changes
Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.Fix
HTMLAttributesnot being applied to the editor DOM whenresizeis enabled. TheaddNodeViewpath was using only the resolved node attributes and skipping the user-configuredHTMLAttributesoption. Now it merges them consistently with howrenderHTMLalready works.
@tiptap/extension-list
Minor Changes
ListKeymap's Backspace handler now lifts the current list item before merging. At the start of a non-first list item, the item is lifted out of its wrapping list (splitting the list around it) instead of immediately joining its content into the previous item. A second Backspace then hits the existing "paragraph after a list" branch and merges the lifted textblock's content into the previous list's last item. Mirrors the two-step behavior introduced for blockquote in #7891.
Patch Changes
Fix delete at the end of a list item with a branching nested sublist. Nested items are hoisted to the parent list instead of being node-selected and deleted on the next keypress.
@tiptap/extensions
Minor Changes
Allow
emptyNodeClassin the Placeholder extension to accept a function that returns a dynamic CSS class name per node
@tiptap/static-renderer
Patch Changes
Fix blockquote markdown rendering to add a trailing newline so subsequent content is not incorrectly included in the blockquote
Fix the types of the JSON static renderers (
renderJSONContentToReactElementandrenderJSONContentToString): you can now passJSONContentdirectly and read node fields likenode.textin your mappings without type errors or casts.
@tiptap/extension-table
Patch Changes
Fix
HTMLAttributesnot being applied to the<table>element whenresizableis disabled (the default). TheTableViewnode view (introduced in 3.23) bypassedrenderHTMLand never applied user-configured attributes likeclassordata-*to the rendered table element.
@tiptap/pm
Patch Changes
Bump
prosemirror-tablesto^1.8.0sofindTableis available from@tiptap/pm, and align the related ProseMirror dependencies with the versions required byprosemirror-tables.
@tiptap/extension-unique-id
Patch Changes
Fix memory leak when destroying an editor before the collaboration provider syncs. The
syncedlistener registered inonCreatewas only removed once the event fired, so destroying the editor first left thecreateIdsclosure (and the whole editor it captures) referenced by the shared provider. The listener is now also detached on destroy, so the editor can be garbage collected.
@tiptap/extension-code
Patch Changes
Fixed a bug where typing a character before an inline code markdown shortcut (e.g.
afollowed by backtick-delimited code) would delete the preceding character. The preceding character is now preserved.
@tiptap/extension-collaboration-caret
Patch Changes
Fix crash when awareness state value is null or undefined (e.g. after a client disconnects)
@tiptap/extension-collaboration
Patch Changes
Fixed
onContentErrornot being triggered when invalid collaborative content is detected. ThefilterTransactionhook now allows the transaction through to keep ProseMirror state in sync with Yjs, ensuring thecontentErrorevent fires correctly.
@tiptap/markdown
Patch Changes
Fix backslash-escape handling in the Markdown parser and serializer. Parsing a backslash-escaped markdown character (e.g.
\*,\_,\\) now correctly produces a literal text node, instead of silently dropping the character. On serialization, characters that have special meaning in markdown inline syntax (*,_,`,[,],\,~) are now backslash-escaped in non-code text nodes to prevent them from being misinterpreted as formatting delimiters when the output is parsed again.
@tiptap/vue-3
Patch Changes
Fix
VueNodeViewRendererthrashing the DOM whencontentDOMis null for non-leaf nodes. The renderer now always creates a contentDOM element for non-leaf nodes (matching React's behavior), so ProseMirror has a valid element to render children into even when the NodeView component does not includeNodeViewContentor renders it conditionally.
@tiptap/vue-2
Patch Changes
Fix
VueNodeViewRendererthrashing the DOM whencontentDOMis null for non-leaf nodes. The renderer now always creates a contentDOM element for non-leaf nodes (matching React's behavior), so ProseMirror has a valid element to render children into even when the NodeView component does not includeNodeViewContentor renders it conditionally.
3.24.0
29 May 2026Fix memory leak when destroying an editor while the collaboration provider stays alive (e.g. multiple editors sharing one provider). The extension's awareness
updatelistener is now removed on destroy, so the editor can be garbage collected.Fix a memory leak where destroying an editor while its Y.Doc/provider stays alive (e.g. multiple editors sharing one provider) left the editor uncollectable. Yjs' UndoManager registered a
doc.on('destroy', ...)listener that was never removed, keeping the UndoManager — and through it the whole editor — reachable from the long-lived doc. Fixed upstream in@tiptap/y-tiptap; this bumps the dependency to pull in the fix.Exclude
toTextproperty when serializing the schema into a JSON object, because it is a function and functions are not serializable.
@tiptap/extension-collaboration-caret
Patch Changes
Fix memory leak when destroying an editor while the collaboration provider stays alive (e.g. multiple editors sharing one provider). The extension's awareness
updatelistener is now removed on destroy, so the editor can be garbage collected.
@tiptap/extension-collaboration
Patch Changes
Fix a memory leak where destroying an editor while its Y.Doc/provider stays alive (e.g. multiple editors sharing one provider) left the editor uncollectable. Yjs' UndoManager registered a
doc.on('destroy', ...)listener that was never removed, keeping the UndoManager — and through it the whole editor — reachable from the long-lived doc. Fixed upstream in@tiptap/y-tiptap; this bumps the dependency to pull in the fix.
@tiptap/server-ai-toolkit
Patch Changes
Exclude
toTextproperty when serializing the schema into a JSON object, because it is a function and functions are not serializable.
@tiptap/pm
Patch Changes
Add missing
@tiptap/pm/inputrulesexport
@tiptap/extension-details
Patch Changes
Fix persisted details toggles when the details node is at the start of the document.
@tiptap/markdown
Patch Changes
Fix text inside unknown angle-bracket tags being silently swallowed during markdown parsing. HTML-like content such as
<enter existing CID here if available>that does not map to any known element is now preserved as literal text instead of disappearing, which also prevents downstreamcontentMatchAterrors when complex schemas (Mention, Variable, Table) are in use.
@tiptap/static-renderer
Patch Changes
Honor the
textDirectioneditor option inrenderToHTMLString,renderToMarkdown, andrenderToReactElement, and omitnull/undefinedattribute values instead of serializing them as the literal string"null".
@tiptap/extensions
Patch Changes
Fix placeholder flickering during collaborative editing and reduce scroll-time CPU usage by deferring viewport recomputation to rAF, adding an overscan margin, and throttling scroll updates
@tiptap/extension-table-of-contents
Minor Changes
Add
generateTocIds, a server-side utility that assignsidanddata-toc-idattributes to anchor nodes in a Tiptap JSON document without needing anEditorinstance.
3.23.6
21 May 2026DragHandle: Added
dragImagePropertiesoption to limit which CSS properties are cloned for the drag image. By default all ~300+ computed styles are copied; setting this to a subset (e.g.['color', 'background-color', 'font-size']) reduces the cost when dragging selections with complex nodes.Fix deleteSelection to properly handle inline nodes with
text*content. The selection is now expanded to include the entire inline node boundaries when deleting, preventing incorrect collapse of inline text nodes.Placeholder: Replaced full-document
doc.descendants()traversal with a cursor-resolved fast path for the default config and viewport-limited scanning for the non-default config, significantly reducing decoration overhead on large documents.
@tiptap/extension-drag-handle
Patch Changes
DragHandle: Added
dragImagePropertiesoption to limit which CSS properties are cloned for the drag image. By default all ~300+ computed styles are copied; setting this to a subset (e.g.['color', 'background-color', 'font-size']) reduces the cost when dragging selections with complex nodes.
@tiptap/core
Patch Changes
Fix deleteSelection to properly handle inline nodes with
text*content. The selection is now expanded to include the entire inline node boundaries when deleting, preventing incorrect collapse of inline text nodes.
@tiptap/extensions
Patch Changes
Placeholder: Replaced full-document
doc.descendants()traversal with a cursor-resolved fast path for the default config and viewport-limited scanning for the non-default config, significantly reducing decoration overhead on large documents.
3.23.5
19 May 2026Respect explicit
immediatelyRender: truein client-side Next.js. Previously, when running under Next.js (window.nextpresent), theimmediatelyRenderoption was forced tofalseeven when the user explicitly passedtrue, breaking client-only Next.js apps that rely on the editor existing on the first render. The hook now only forcesfalsewhen actual SSR is detected (typeof window === 'undefined'), or when running under Next.js with no explicit value.nodeview: Eliminate unnecessary re-renders, add opt-in position tracking
NodeViews no longer re-render when decorations or position change without
content changes. AddedtrackNodeViewPositionoption — when enabled, the
component re-renders on every position shift so calls togetPos()stay
current in render output. Removed the internalnodeViewPositionRegistry.
Added shallow prop comparison inReactRenderer.updateProps().
@tiptap/react
Patch Changes
Respect explicit
immediatelyRender: truein client-side Next.js. Previously, when running under Next.js (window.nextpresent), theimmediatelyRenderoption was forced tofalseeven when the user explicitly passedtrue, breaking client-only Next.js apps that rely on the editor existing on the first render. The hook now only forcesfalsewhen actual SSR is detected (typeof window === 'undefined'), or when running under Next.js with no explicit value.nodeview: Eliminate unnecessary re-renders, add opt-in position tracking
NodeViews no longer re-render when decorations or position change without
content changes. AddedtrackNodeViewPositionoption — when enabled, the
component re-renders on every position shift so calls togetPos()stay
current in render output. Removed the internalnodeViewPositionRegistry.
Added shallow prop comparison inReactRenderer.updateProps().
3.23.4
13 May 2026Add a new
autoTrimoption toCharacterCountwhich can be used to allow exceeding the character limit and either trim or validate the content length manually
3.23.2
12 May 2026Default
immediatelyRendertofalsein SSR environments instead of throwing an errorPreviously, omitting
immediatelyRenderin an SSR environment (e.g. Next.js) would throw an error in development and silently returnnullin production. This was a common source of crashes, especially when AI-generated code set up the editor without explicitly passingimmediatelyRender: false. The hook now defaultsimmediatelyRendertotrue, but automatically sets it tofalsewhen SSR is detected, logging a warning in development instead of throwing.
@tiptap/react
Patch Changes
Default
immediatelyRendertofalsein SSR environments instead of throwing an errorPreviously, omitting
immediatelyRenderin an SSR environment (e.g. Next.js) would throw an error in development and silently returnnullin production. This was a common source of crashes, especially when AI-generated code set up the editor without explicitly passingimmediatelyRender: false. The hook now defaultsimmediatelyRendertotrue, but automatically sets it tofalsewhen SSR is detected, logging a warning in development instead of throwing.
3.23.1
8 May 2026Only updates dependencies:@tiptap/core 3.23.1@tiptap/pm 3.23.1
3.22.5
28 Apr 2026Add
selectedOnTextSelectionoption to node view renderers. When enabled, theselectedprop also becomes true when a TextSelection is fully inside the node's range, not only on NodeSelection.
@tiptap/react
Patch Changes
Add
selectedOnTextSelectionoption to node view renderers. When enabled, theselectedprop also becomes true when a TextSelection is fully inside the node's range, not only on NodeSelection.
3.22.4
18 Apr 2026Fix dependencies installation after packages updates producing peer dependency resolution conflicts
@tiptap/react
Patch Changes
Fix dependencies installation after packages updates producing peer dependency resolution conflicts
3.22.3
8 Apr 2026Fixed
insertContentAtcorrupting the document when inserting inline content with marks at the start of a paragraph. Thefrom - 1position adjustment now only applies to block-level content.Add an option to control whether node ranges extend when a selection only touches a node boundary.
Remove unnecessary
xmlns="http://www.w3.org/1999/xhtml"attribute fromgenerateHTMLoutput by usinginnerHTMLinstead ofXMLSerializerfor HTML serialization.
@tiptap/core
Patch Changes
Fixed
insertContentAtcorrupting the document when inserting inline content with marks at the start of a paragraph. Thefrom - 1position adjustment now only applies to block-level content.
@tiptap/extension-node-range
Patch Changes
Add an option to control whether node ranges extend when a selection only touches a node boundary.
@tiptap/html
Patch Changes
Remove unnecessary
xmlns="http://www.w3.org/1999/xhtml"attribute fromgenerateHTMLoutput by usinginnerHTMLinstead ofXMLSerializerfor HTML serialization.
@tiptap/extension-drag-handle
Patch Changes
Fix drag selections so crossing a node boundary does not incorrectly include the next node.
@tiptap/starter-kit
3.22.2
4 Apr 2026Fixed an error where
flushSync()would run in<EditorContent />lifecycle
Patch Changes
Fixed an error where
flushSync()would run in<EditorContent />lifecycle
3.22.1
2 Apr 2026Fix NodeView not re-rendering when a node's position changes without content or decoration changes (e.g. when a sibling node is moved within the same parent)
Prevent React node views from crashing during deferred selection updates when ProseMirror has already detached the node view position lookup.
3.22.0
31 Mar 2026Use a named import for Suggestion from
@tiptap/suggestionto avoid bundler ESM/CJS interop
wrapping (__toESM) that caused CJS consumers to receive a module object instead of the
callable plugin factory.This is a non-breaking internal fix identical to the one applied to
@tiptap/extension-mention
in #6994.Moved content validation from Yjs
beforeTransaction(whose return value was ignored) to ProseMirrorfilterTransaction, so invalid collaborative changes are now properly blocked.Prevent hidden bubble menus from reappearing during scroll and resize updates. Bubble menu positioning now only runs for menus that are already shown, so default text-selection menus stay hidden until they should actually open.
@tiptap/extension-emoji
Patch Changes
Use a named import for Suggestion from
@tiptap/suggestionto avoid bundler ESM/CJS interop
wrapping (__toESM) that caused CJS consumers to receive a module object instead of the
callable plugin factory.This is a non-breaking internal fix identical to the one applied to
@tiptap/extension-mention
in #6994.
@tiptap/extension-collaboration
Patch Changes
Moved content validation from Yjs
beforeTransaction(whose return value was ignored) to ProseMirrorfilterTransaction, so invalid collaborative changes are now properly blocked.
@tiptap/extension-bubble-menu
Patch Changes
Prevent hidden bubble menus from reappearing during scroll and resize updates. Bubble menu positioning now only runs for menus that are already shown, so default text-selection menus stay hidden until they should actually open.
@tiptap/core
Patch Changes
Fix HTML character escaping in markdown roundtrip. HTML entities (
<,>,&,") are now decoded to literal characters when parsing markdown into the editor.<,>, and&are re-encoded when serializing back to markdown, while"is preserved as a literal character since double quotes are ordinary in markdown. Code detection for skipping encoding now uses thecode: trueextension spec instead of hardcoded type names. Literal characters inside code blocks and inline code are always preserved.Fix ResizableNodeView ignoring node's inline setting by using
inline-flexfor inline nodes andflexfor block nodesextendMarkRange defaults to using the attributes of the first mark of the given type, instead of
attributes = {}. In particular,extendMarkRange('link')no longer extends to adjacent links with different hrefs; restore the previous behavior withextendMarkRange('link', {}).Fix getMarkRange attributes default to consider the first mark of the given type
Guard mark delete event handling when
unsetMarkremoves a mark from inline content that starts at position0, preventing aRangeErrorduring the before-node lookup.
@tiptap/markdown
Patch Changes
Fix HTML character escaping in markdown roundtrip. HTML entities (
<,>,&,") are now decoded to literal characters when parsing markdown into the editor.<,>, and&are re-encoded when serializing back to markdown, while"is preserved as a literal character since double quotes are ordinary in markdown. Code detection for skipping encoding now uses thecode: trueextension spec instead of hardcoded type names. Literal characters inside code blocks and inline code are always preserved.
@tiptap/extension-mathematics
Patch Changes
Prevent inline math input rule from capturing previous character. Changed input rule to utilize negative lookbehind to prevent matching previous character. Ensures the range's
fromposition is correctly at the start of the double$signs.
@tiptap/suggestion
Patch Changes
Suggestions dismissed via Escape no longer reappear when the user keeps typing in the same word — they only come back after inserting whitespace, a newline, or moving the cursor to a different trigger.
@tiptap/extension-details
Patch Changes
Fix a rerender loop in the Details node view when the toggle button updates its DOM attributes through
renderToggleButton.
@tiptap/html
Patch Changes
Updated happy-dom to 20.8.9
@tiptap/extension-table
Minor Changes
Added Markdown table alignment support. The
TableCellandTableHeadernodes now have analignattribute (left,center,right) that is parsed from Markdown column alignment markers (:---,---:,:---:) and serialized back when rendering to Markdown. Alignment is also parsed from and rendered to HTML viastyle="text-align: ...".
3.21.0
27 Mar 2026Add a
renderToggleButtonoption to customize the details toggle button, including its accessible label.Fix custom markdown tokenizer helper lexing to use Marked's active lexer so ordered list parsing no longer breaks inline tokenization in following paragraphs.
Updated
findElementNextToCoordsto fall back toview.posAtCoordswhenelementsFromPointreturns no matching block, resolving the position to the top-level block node.
@tiptap/extension-details
Minor Changes
Add a
renderToggleButtonoption to customize the details toggle button, including its accessible label.
@tiptap/markdown
Patch Changes
Fix custom markdown tokenizer helper lexing to use Marked's active lexer so ordered list parsing no longer breaks inline tokenization in following paragraphs.
@tiptap/extension-drag-handle
Patch Changes
Updated
findElementNextToCoordsto fall back toview.posAtCoordswhenelementsFromPointreturns no matching block, resolving the position to the top-level block node.
@tiptap/extension-emoji
Patch Changes
Update emoji dataset to include latest Unicode emojis.
3.20.6
27 Mar 2026Fix drag preview cleanup so cloned drag images are also removed when dragging ends without a valid drop.
3.20.5
24 Mar 2026Add support for skipping trailing node insertion on transactions by setting the
skipTrailingNodemeta flag.
3.20.4
17 Mar 2026Only updates dependencies:@tiptap/core 3.20.4@tiptap/pm 3.20.4
3.20.3
16 Mar 2026Forward BubbleMenu and FloatingMenu HTML props to the actual menu element so attributes like
className,style,data-*, and event handlers bind to the positioned menu container.Generate a stable per-instance menu plugin key automatically when
pluginKeyis omitted, so multiple BubbleMenu or FloatingMenu components can be mounted without colliding.
3.20.2
15 Mar 2026Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.
@tiptap/core
Patch Changes
Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.
@tiptap/extension-blockquote
Patch Changes
Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.
@tiptap/extension-list
Patch Changes
Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.
@tiptap/extension-paragraph
Patch Changes
Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.
@tiptap/markdown
Patch Changes
Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.
3.20.1
6 Mar 2026Fix tilde-fenced code blocks (
~~~) being silently dropped when parsing markdownFix Drag event listener is removed when a plugin is registered after the DragHandle plugin.
Add support for
types: 'all'inUniqueIDto target every node type exceptdocandtext.
@tiptap/extension-code-block
Patch Changes
Fix tilde-fenced code blocks (
~~~) being silently dropped when parsing markdown
@tiptap/extension-drag-handle
Patch Changes
Fix Drag event listener is removed when a plugin is registered after the DragHandle plugin.
@tiptap/extension-unique-id
Patch Changes
Add support for
types: 'all'inUniqueIDto target every node type exceptdocandtext.
@tiptap/core
Patch Changes
Fix inline
styleparsing inmergeAttributesfor values containing:or;(e.g.url(https://...)orurl(data:...;charset=...,)) and skip incomplete declarations
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.