@tiptap/extension-details
3.35.0 · 20 Nov 2026MIT871.4k / weekRepositoryHomepagenpmAtom feed
136 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 3.x · latest line
3.4.0
4 Sep 2025Fixed an issue where the input method editor (IME) failed to handle Chinese text correctly when entering the first word. Users can now input multiple words as expected.
3.3.1
2 Sep 2025Reading the note…
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 2025Reading the note…
3.2.1
21 Aug 2025Reading the note…
3.2.0
14 Aug 2025Only updates dependencies:@tiptap/core 3.2.0@tiptap/extension-text-style 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 2025Reading the note…
3.0.8
1 Aug 2025Reading the note…
3.0.7
16 Jul 2025Reading the note…
3.0.6
15 Jul 2025Reading the note…
3.0.5
15 Jul 2025Reading the note…
3.0.4
15 Jul 2025Reading the note…
3.0.3
15 Jul 2025Reading the note…
3.0.2
15 Jul 2025Reading the note…
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.27.3
4 Sep 20262.27.2
7 Jan 2026Reading the note…
2.27.1
29 Oct 2025Reading the note…
2.27.0
29 Oct 2025Reading the note…
2.26.4
23 Oct 2025Reading the note…
2.26.3
9 Oct 2025Reading the note…
2.26.2
23 Sep 2025Reading the note…
2.26.1
11 Jul 2025Reading the note…
2.26.0
11 Jul 2025Reading the note…
2.25.1
10 Jul 2025Reading the note…
2.25.0
6 Jul 2025Reading the note…
2.24.2
4 Jul 2025Reading the note…
2.24.1
3 Jul 2025Reading the note…
2.24.0
2 Jul 2025Reading the note…
2.23.1
30 Jun 2025Reading the note…
2.23.0
26 Jun 2025Reading the note…
2.22.3
21 Jun 2025Reading the note…
2.22.2
21 Jun 2025Reading the note…
2.22.1
21 Jun 2025Reading the note…
2.22.0
20 Jun 2025Reading the note…
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.