@tiptap/extension-file-handler
3.35.0 · 20 Nov 2026MIT1.1M / weekRepositoryHomepagenpmAtom feed
136 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
3.20.1
6 Mar 2026Reading the note…
3.20.0
18 Feb 2026Add
transformPastedHTMLextension API that allows extensions to transform pasted HTML content before it's parsed into the editor, enabling cleanup of styles, removal of dangerous content, and modification of pasted HTML through a chainable transform system.Fix checking if mark is active and toggling off marks when part of the selection does not allow the mark (e.g. a code block)
Global attributes now support shorthand string values for
types: use'*'to apply to all nodes and marks,'nodes'for all nodes (excluding text), or'marks'for all marks.
@tiptap/core
Minor Changes
Add
transformPastedHTMLextension API that allows extensions to transform pasted HTML content before it's parsed into the editor, enabling cleanup of styles, removal of dangerous content, and modification of pasted HTML through a chainable transform system.
Patch Changes
Fix checking if mark is active and toggling off marks when part of the selection does not allow the mark (e.g. a code block)
Global attributes now support shorthand string values for
types: use'*'to apply to all nodes and marks,'nodes'for all nodes (excluding text), or'marks'for all marks.
@tiptap/extension-drag-handle
Patch Changes
Fix drag handle not appearing for atom/leaf nodes like images in both nested and non-nested modes
Add table structure rules to prevent drag handle on table rows, cells, and headers, and fix ghost table rows when dragging tables
Fix drag position resolving outside the document when dragging an empty text node at the end of the document
@tiptap/markdown
Patch Changes
Fixed getMarkdown() returning
instead of empty string when editor is empty
@tiptap/extension-bubble-menu
Patch Changes
Fix
BubbleMenu/FloatingMenuto usepluginKeyas the transaction meta key so that multiple instances can be updated independently without affecting each other
@tiptap/extension-floating-menu
Patch Changes
Fix
BubbleMenu/FloatingMenuto usepluginKeyas the transaction meta key so that multiple instances can be updated independently without affecting each other
@tiptap/react
Minor Changes
Moved BubbleMenu and FloatingMenu to separate
@tiptap/react/menusentrypoint to keep floating-ui optionalSimplified Tiptap component API with guaranteed non-null editor instance from useTiptap hook
Patch Changes
Fix
BubbleMenu/FloatingMenuto usepluginKeyas the transaction meta key so that multiple instances can be updated independently without affecting each other
@tiptap/extension-code-block-lowlight
Patch Changes
Fixed a runtime error when initializing
CodeBlockLowlightby switching theCodeBlockimport to a named export. This preventsextend is not a functionerrors caused by ESM/CJS interop issues.
@tiptap/extension-invisible-characters
Patch Changes
Added missing storage typings
3.19.0
3 Feb 2026Add
titleattribute to Link extension. The title can now be set viasetLinkandtoggleLinkcommands and is rendered as an HTML title attribute.Add title attribute support for markdown rendering. Links with titles are now serialized to markdown format
[text](url "title").Moved BubbleMenu and FloatingMenu to separate
@tiptap/react/menusentrypoint to keep floating-ui optional
@tiptap/extension-link
Patch Changes
Add
titleattribute to Link extension. The title can now be set viasetLinkandtoggleLinkcommands and is rendered as an HTML title attribute.Add title attribute support for markdown rendering. Links with titles are now serialized to markdown format
[text](url "title").
@tiptap/react
Minor Changes
Moved BubbleMenu and FloatingMenu to separate
@tiptap/react/menusentrypoint to keep floating-ui optionalSimplified Tiptap component API with guaranteed non-null editor instance from useTiptap hook
3.18.0
28 Jan 2026Fix BubbleMenu and FloatingMenu props not updating after initialization
Fix BubbleMenu and FloatingMenu props not updating after initialization
Introduce a new, optional React integration that provides a declarative
<Tiptap />component for setting up editors in React apps.Summary
Why this change
Migration and usage
Example
import { Tiptap, useEditor } from '@tiptap/react' function MyEditor() { const editor = useEditor({ extensions: [StarterKit], content: '<h1>Hello from Tiptap</h1>' }) return ( <Tiptap instance={editor}> <Tiptap.Content /> <Tiptap.BubbleMenu>My Bubble Menu</Tiptap.BubbleMenu> <Tiptap.FloatingMenu>My Floating Menu</Tiptap.FloatingMenu> <MenuBar /> {/* MenuBar can use the new `useTiptap` hook to read the editor instance from context */} </Tiptap> ) }Deprecation plan
@tiptap/extension-bubble-menu
Patch Changes
Fix BubbleMenu and FloatingMenu props not updating after initialization
@tiptap/extension-floating-menu
Patch Changes
Fix BubbleMenu and FloatingMenu props not updating after initialization
@tiptap/react
Minor Changes
Introduce a new, optional React integration that provides a declarative
<Tiptap />component for setting up editors in React apps.Summary
Add a new, ergonomic way to initialize and use Tiptap editors in React via
<Tiptap />components. This is an additive change and does not remove or change existing APIs.
Why this change
Improves ergonomics for React users by offering a component-first API that pairs well with React patterns (hooks, JSX composition and props-driven configuration).
Migration and usage
The old programmatic setup remains supported for this major version — nothing breaks. We encourage consumers to try the new
<Tiptap />component and migrate when convenient.
Example
import { Tiptap, useEditor } from '@tiptap/react' function MyEditor() { const editor = useEditor({ extensions: [StarterKit], content: '<h1>Hello from Tiptap</h1>' }) return ( <Tiptap instance={editor}> <Tiptap.Content /> <Tiptap.BubbleMenu>My Bubble Menu</Tiptap.BubbleMenu> <Tiptap.FloatingMenu>My Floating Menu</Tiptap.FloatingMenu> <MenuBar /> {/* MenuBar can use the new `useTiptap` hook to read the editor instance from context */} </Tiptap> ) }Deprecation plan
The old imperative setup will remain fully backward-compatible for this major release. We plan to deprecate (and remove) the legacy setup in the next major version — a deprecation notice and migration guide will be published ahead of that change.
Patch Changes
Fix BubbleMenu and FloatingMenu props not updating after initialization
Fixed extension storage not updating in React and Vue node views
@tiptap/vue-3
Patch Changes
Fixed extension storage not updating in React and Vue node views
@tiptap/markdown
@tiptap/extensions
Patch Changes
Added a new
dataAttributeto the extension option to control which attribute name will be used for the placeholder label.
3.17.1
24 Jan 2026Reading the note…
3.17.0
23 Jan 2026Added a safeguard to avoid
TypeError: Cannot read properties of null (reading 'domFromPos')being thrown when the editor was being destroyedAdded nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
Fixed Firefox bug where the text caret becomes invisible after drag and drop.
@tiptap/extension-bubble-menu
Patch Changes
Added a safeguard to avoid
TypeError: Cannot read properties of null (reading 'domFromPos')being thrown when the editor was being destroyed
@tiptap/extension-drag-handle
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
Patch Changes
Fixed Firefox bug where the text caret becomes invisible after drag and drop.
@tiptap/core
Patch Changes
Added
isFirefoxutility to core
@tiptap/extension-drag-handle-react
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
@tiptap/extension-drag-handle-vue-2
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
@tiptap/extension-drag-handle-vue-3
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
3.16.0
20 Jan 2026Add a native audio extension with demos and tests.
Fix incorrect Markdown output when underline is mixed with bold or italic and their ranges do not fully overlap.
Fix overlapping underline/bold/italic serialization and add tests
@tiptap/extension-audio
Minor Changes
Add a native audio extension with demos and tests.
@tiptap/markdown
Patch Changes
Fix incorrect Markdown output when underline is mixed with bold or italic and their ranges do not fully overlap.
Fix overlapping underline/bold/italic serialization and add tests
@tiptap/extension-link
Patch Changes
Fixed an issue where clicking on non-link elements (like images) required multiple clicks to select them. The link click handler now properly returns early when the clicked element is not a link, allowing other node handlers to process the click event.
@tiptap/extension-floating-menu
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/react
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/vue-2
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/vue-3
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/extension-unique-id
Patch Changes
Improved
findDuplicateshelper performance from O(n²) to O(n) by using Set-based lookups instead of Array.indexOf
3.15.3
7 Jan 2026Reading the note…
3.15.2
7 Jan 2026Reading the note…
3.15.1
6 Jan 2026Reading the note…
3.15.0
5 Jan 2026Add a new
dispatchTransactionhook to extensions, allowing developers to intercept, modify, or block transactions before they are applied to the editor state.Fix unique ID assignment when handling empty nodes by checking next node's attribute state in the transaction document before modifying it, preventing incorrect ID assignments.
3.14.0
19 Dec 2025Add new Twitch extension for embedding Twitch videos, clips, and live channels in the editor. Supports customizable parameters like autoplay, muted, and start time, with attribute-level overrides for per-embed configuration.
Documentation: tiptap.dev/docs/editor/extensions/nodes/twitch
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/extension-twitch
Minor Changes
Add new Twitch extension for embedding Twitch videos, clips, and live channels in the editor. Supports customizable parameters like autoplay, muted, and start time, with attribute-level overrides for per-embed configuration.
Documentation: tiptap.dev/docs/editor/extensions/nodes/twitch
@tiptap/react
Patch Changes
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/vue-2
Patch Changes
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/vue-3
Patch Changes
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/extension-drag-handle
Patch Changes
Fix
findElementNextToCoordsto resolve the parent whennodeAt(pos)is null
(e.g., inside an atom node that allows inline content)
3.13.0
5 Dec 2025Added
data-draggingattribute to drag handle elements to track drag state.Added
data-draggingattribute to drag handle elements to track drag state.Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle-react
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle-vue-2
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle-vue-3
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-link
Patch Changes
Ensure
enableClickSelectionworks regardless of theopenOnClickoption by always registering the link click handler plugin.
@tiptap/extension-table-of-contents
Patch Changes
Skip the table of contents update logic during IME input method composition to avoid interference with input.
@tiptap/markdown
Patch Changes
Fixed trailing and leading whitespace handling in markdown serialization for inline marks
@tiptap/extension-mention
Patch Changes
Add 'mentionSuggestionChar' to allowedAttributes for Markdown serialization in multi-mention setups. The attribute is only serialized when it differs from the default '@' character, keeping markdown output clean for single-mention users.
@tiptap/core
Minor Changes
Added an optional
createCustomHandlecallback toResizableNodeView, allowing developers to fully customize resize handles. When provided, it replaces the default handle creation and bypasses the built-inpositionHandlelogic, giving complete control over markup, styling, and positioning while preserving backward compatibility.Removed predefined inline styles from the
wrapperelement to better support dynamic alignment. This eliminates the need for!importantoverrides in user styles.Added an editor
updateevent listener to dynamically attach or remove resize handles based on the editor’s editable state. The implementation tracks the previous editable state to avoid unnecessary re-renders.
Patch Changes
Add 'mentionSuggestionChar' to allowedAttributes for Markdown serialization in multi-mention setups. The attribute is only serialized when it differs from the default '@' character, keeping markdown output clean for single-mention users.
@tiptap/extension-image
Minor Changes
Added an optional
createCustomHandlecallback toResizableNodeView, allowing developers to fully customize resize handles. When provided, it replaces the default handle creation and bypasses the built-inpositionHandlelogic, giving complete control over markup, styling, and positioning while preserving backward compatibility.Removed predefined inline styles from the
wrapperelement to better support dynamic alignment. This eliminates the need for!importantoverrides in user styles.Added an editor
updateevent listener to dynamically attach or remove resize handles based on the editor’s editable state. The implementation tracks the previous editable state to avoid unnecessary re-renders.
3.12.1
3 Dec 2025Reading the note…
3.12.0
2 Dec 2025Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Avoid mutating
this.optionsin theupdateUsercommand.this.optionscan be a getter and is not writable; the command now updates the provider awareness directly so user updates are applied correctly.
@tiptap/extension-collaboration
Minor Changes
Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Introduce
MappablePositionclass in core withposition,fromJSON, andtoJSONmethodsAdd
editor.utilsproperty withgetUpdatedPosition(position, transaction)andcreateMappablePosition()methodsCreate
CollaborationMappablePositionsubclass that extendsMappablePositionwith Y.js relative position support
@tiptap/core
Minor Changes
Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Introduce
MappablePositionclass in core withposition,fromJSON, andtoJSONmethodsAdd
editor.utilsproperty withgetUpdatedPosition(position, transaction)andcreateMappablePosition()methodsCreate
CollaborationMappablePositionsubclass that extendsMappablePositionwith Y.js relative position support
@tiptap/extension-collaboration-caret
Patch Changes
Avoid mutating
this.optionsin theupdateUsercommand.this.optionscan be a getter and is not writable; the command now updates the provider awareness directly so user updates are applied correctly.
@tiptap/react
Minor Changes
Replaced unmaintained
fast-deep-equaldependency with maintainedfast-equals
Patch Changes
Fix a bug where React node views could receive invalid positions from
this.getPos()when ProseMirror and React render cycles got out of sync, which could cause errors during updates.
3.11.1
27 Nov 2025Reading the note…
3.11.0
19 Nov 2025Add native text direction support for RTL and bidirectional content. The editor now includes a
textDirectionoption that can be set to'ltr','rtl', or'auto'to control the direction of all content globally. Additionally, newsetTextDirectionandunsetTextDirectioncommands allow for granular control of text direction on specific nodes. This enables proper rendering of right-to-left languages like Arabic and Hebrew, as well as bidirectional text mixing multiple languages.
3.10.8
18 Nov 2025Reading the note…
3.10.7
12 Nov 2025Reading the note…
3.10.6
12 Nov 2025Reading the note…
3.10.5
10 Nov 2025Reading the note…
3.10.4
8 Nov 2025Reading the note…
3.10.3
7 Nov 2025Reading the note…
3.10.2
5 Nov 2025Reading the note…
3.10.1
30 Oct 2025Reading the note…
3.10.0
30 Oct 2025Reading the note…
3.9.1
29 Oct 2025Reading the note…
3.9.0
28 Oct 2025Reading the note…
3.8.0
24 Oct 2025Reading the note…
3.7.2
16 Oct 2025Reading the note…
3.7.1
15 Oct 2025Reading the note…
3.7.0
14 Oct 2025Reading the note…
3.6.7
14 Oct 2025Reading the note…
3.6.6
9 Oct 2025Reading the note…
3.6.5
3 Oct 2025Reading the note…
3.6.4
3 Oct 2025Reading the note…
3.6.3
2 Oct 2025Reading the note…
3.6.2
29 Sep 2025Reading the note…
3.6.1
25 Sep 2025Reading the note…
3.6.0
25 Sep 2025Reading the note…
3.5.3
25 Sep 2025Reading the note…
3.5.2
24 Sep 2025Reading the note…
3.5.1
23 Sep 2025Reading the note…
3.5.0
23 Sep 2025Reading the note…
3.4.6
22 Sep 2025Reading the note…
3.4.5
22 Sep 2025Reading the note…
3.4.4
17 Sep 2025Reading the note…
3.4.3
15 Sep 2025Reading the note…
3.4.2
9 Sep 2025Reading the note…
3.4.1
4 Sep 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.