@tiptap/extension-history
3.34.0 · 13 Nov 2026MIT5.7M / 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 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 20253.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 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 💕.
3.0.0
14 Jul 2024- 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.1
21 Jun 2025Update YouTube URL regex pattern
Releases
@tiptap/extension-youtube@2.22.1
Patch Changes
Update YouTube URL regex pattern
@tiptap/react@2.22.1
@tiptap/starter-kit@2.22.1
@tiptap/vue-2@2.22.1
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:
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
Releases
@tiptap/extension-details@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-details-content@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-details-summary@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-drag-handle@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-drag-handle-react@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-drag-handle-vue-2@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-drag-handle-vue-3@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-emoji@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-file-handler@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-invisible-characters@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-mathematics@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-node-range@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-table-of-contents@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/extension-unique-id@2.22.0
Minor Changes
We open sourced our basic pro extensions
This release includes the following extensions that were previously only available in our Pro version:
@tiptap/react@2.22.0
@tiptap/starter-kit@2.22.0
@tiptap/vue-2@2.22.0
@tiptap/vue-3@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
Releases
@tiptap/react@2.14.1
Patch Changes
Fixed 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
@tiptap/extension-bubble-menu@2.14.1
@tiptap/extension-floating-menu@2.14.1
@tiptap/starter-kit@2.14.1
@tiptap/vue-2@2.14.1
@tiptap/vue-3@2.14.1
2.14.0
6 Jun 2025Add config option to emit content error when content check is disabled
Releases
@tiptap/core@2.14.0
Minor Changes
Add config option to emit content error when content check is disabled
@tiptap/react@2.14.0
@tiptap/starter-kit@2.14.0
@tiptap/vue-2@2.14.0
@tiptap/vue-3@2.14.0
2.13.0
5 Jun 2025Improve YouTube embed URL creation, support start timestamps, fix Shorts & Live embeds
Added support for React 19 ref in props
Releases
@tiptap/extension-youtube@2.13.0
Minor Changes
Improve YouTube embed URL creation, support start timestamps, fix Shorts & Live embeds
@tiptap/react@2.13.0
Minor Changes
Added support for React 19 ref in props
@tiptap/starter-kit@2.13.0
@tiptap/vue-2@2.13.0
@tiptap/vue-3@2.13.0
2.12.0
5 May 2025Update prosemirror-changeset library to support token encoders
2.11.9
30 Apr 2025Added new
toggleTextAligncommand to TextAlign extension to make toggling text alignments easier to handle
Releases
@tiptap/extension-text-align@2.11.9
Patch Changes
Added new
toggleTextAligncommand to TextAlign extension to make toggling text alignments easier to handle
@tiptap/react@2.11.9
@tiptap/starter-kit@2.11.9
@tiptap/vue-2@2.11.9
@tiptap/vue-3@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 2025Remove redundant optional chaining in starter kit extension
Upgrade prosemirror-tables to 1.6.4 (fixes #6074)
Use null in ordered list's default type value
What's Changed
Remove redundant optional chaining in starter kit extension
Upgrade prosemirror-tables to 1.6.4 (fixes #6074)
Use null in ordered list's default type value
Add option to set rel on youtube embed link
youtube: Enhance embed URL generation to support video lists
Publish a new stable version
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.