Packages

@tiptap/extension-details

3.35.0 · 20 Nov 2026MIT871.4k / weekRepositoryHomepagenpmAtom feed

Your version

136 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.

  1. 3.20.1

    6 Mar 2026

    Reading the note…

  2. 3.20.0

    18 Feb 2026
    • Add transformPastedHTML extension 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.

  3. 3.19.0

    3 Feb 2026
    • Add title attribute to Link extension. The title can now be set via setLink and toggleLink commands 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/menus entrypoint to keep floating-ui optional

  4. 3.18.0

    28 Jan 2026
    • Fix 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

  5. 3.17.1

    24 Jan 2026

    Reading the note…

  6. 3.17.0

    23 Jan 2026
    • Added a safeguard to avoid TypeError: Cannot read properties of null (reading 'domFromPos') being thrown when the editor was being destroyed

    • 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.

    • Fixed Firefox bug where the text caret becomes invisible after drag and drop.

  7. 3.16.0

    20 Jan 2026
    • Add 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

  8. 3.15.3

    7 Jan 2026

    Reading the note…

  9. 3.15.2

    7 Jan 2026

    Reading the note…

  10. 3.15.1

    6 Jan 2026

    Reading the note…

  11. 3.15.0

    5 Jan 2026
    • Add a new dispatchTransaction hook 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.

  12. 3.14.0

    19 Dec 2025
    • 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

    • 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.

  13. 3.13.0

    5 Dec 2025
    • Added data-dragging attribute to drag handle elements to track drag state.

    • Added data-dragging attribute to drag handle elements to track drag state.

    • Added data-dragging attribute to drag handle elements to track drag state.

  14. 3.12.1

    3 Dec 2025

    Reading the note…

  15. 3.12.0

    2 Dec 2025
    • Implement position mapping using the MappablePosition class. This enables position mapping in collaborative editing scenarios.

    • Implement position mapping using the MappablePosition class. This enables position mapping in collaborative editing scenarios.

    • Avoid mutating this.options in the updateUser command. this.options can be a getter and is not writable; the command now updates the provider awareness directly so user updates are applied correctly.

  16. 3.11.1

    27 Nov 2025

    Reading the note…

  17. 3.11.0

    19 Nov 2025
    • Add native text direction support for RTL and bidirectional content. The editor now includes a textDirection option that can be set to 'ltr', 'rtl', or 'auto' to control the direction of all content globally. Additionally, new setTextDirection and unsetTextDirection commands 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.

  18. 3.10.8

    18 Nov 2025

    Reading the note…

  19. 3.10.7

    12 Nov 2025

    Reading the note…

  20. 3.10.6

    12 Nov 2025

    Reading the note…

  21. 3.10.5

    10 Nov 2025

    Reading the note…

  22. 3.10.4

    8 Nov 2025

    Reading the note…

  23. 3.10.3

    7 Nov 2025

    Reading the note…

  24. 3.10.2

    5 Nov 2025

    Reading the note…

  25. 3.10.1

    30 Oct 2025

    Reading the note…

  26. 3.10.0

    30 Oct 2025
    • Add a new ResizableNodeview NodeView to core that wraps elements (images, videos, iframes) with configurable resize handles. It provides live onResize/onCommit callbacks, min/max constraints, aspect-ratio support, and styling hooks (class names + data attributes) to improve UX when resizing media inside the editor.

    • The addNodeView function can now return null to dynamically disable rendering of a node view

      While this should not directly cause any issues, it's noteworthy as it still could affect some behavior in some edge cases.

    • Added a new resize option that allows images to be resized. The option adds resize handlers to images allowing users to manually resize images via drag and drop or touch

  27. 3.9.1

    29 Oct 2025

    Reading the note…

  28. 3.9.0

    28 Oct 2025
    • Fix attribute forwarding for BubbleMenu and FloatingMenu Vue 3 components to allow setting z-index and other HTML attributes

    • Ensure that markdown hard breaks (two spaces followed by a newline) are parsed so they render as line breaks (<br>) in the editor when using contentType: 'markdown'.

      Fixes #7107

    • Add updateDocument option to disable document updates caused by the Unique ID extension.

  29. 3.8.0

    24 Oct 2025
    • Add updateDocument option to disable document updates caused by the Unique ID extension.

    • Prevent Bubble Menu plugin from re-loading every time the BubbleMenu component re-renders. Reverts a regression introduced in v3.6.3, in PR #7028.

  30. 3.7.2

    16 Oct 2025

    Reading the note…

  31. 3.7.1

    15 Oct 2025

    Reading the note…

  32. 3.7.0

    14 Oct 2025
    • All commands and their corresponding TypeScript types are now exported from @tiptap/core so they can be imported and referenced directly by consumers. This makes it easier to build typed helpers, extensions, and tests that depend on the command signatures.

      Why:

      import { commands } from '@tiptap/core'

      Notes:

    • Add comprehensive bidirectional markdown support to Tiptap through a new @tiptap/markdown package and Markdown utilities in @tiptap/core.

      New Package: @tiptap/markdown - A new official extension that provides full Markdown parsing and serialization capabilities using MarkedJS as the underlying Markdown parser.

      Core Features:

      Extension API

    • editor.getMarkdown(): Serialize current editor content to Markdown string

  33. 3.6.7

    14 Oct 2025

    Reading the note…

  34. 3.6.6

    9 Oct 2025

    Reading the note…

  35. 3.6.5

    3 Oct 2025

    Reading the note…

  36. 3.6.4

    3 Oct 2025

    Reading the note…

  37. 3.6.3

    2 Oct 2025

    Reading the note…

  38. 3.6.2

    29 Sep 2025

    Reading the note…

  39. 3.6.1

    25 Sep 2025

    Reading the note…

  40. 3.6.0

    25 Sep 2025
    • Removed

      Remove recently added updateBubbleMenuPosition method because it would not work in the React and Vue versions of the BubbleMenu, only in the vanilla extension. And that would confuse developers.

      Write the transactionHandler method as an arrow function because arrow functions have no this, so the this remains the instance of the BubbleMenuView class.

    • Improve typing and docs for EditorOptions.element to reflect all supported mounting modes and align behavior across adapters.

    • Parse cell colwidth from nearest <colgroup> when missing on the cell

      When importing HTML, table column widths are often declared on a surrounding <colgroup> rather than on each <td>. Previously, tableCell only read the colwidth attribute from the cell itself and would lose width information in that case. The implementation now falls back to reading the corresponding <col>'s width from the table's <colgroup> using the cell's index.

      This is a non-breaking bugfix that preserves layout information when HTML uses <colgroup>. Consider adding a small demo or unit test to assert colwidth is preserved for cells when only the <colgroup> contains width attributes.

  41. 3.5.3

    25 Sep 2025

    Reading the note…

  42. 3.5.2

    24 Sep 2025

    Reading the note…

  43. 3.5.1

    23 Sep 2025

    Reading the note…

  44. 3.5.0

    23 Sep 2025
    • Add updateBubbleMenuPosition command to update position of bubble menu. This command lets developers programmatically update the position of the bubble menu in response to certain events (for example, when the bubble menu is resized).

    • Add getReferencedVirtualElement option to the drag handle extension to customize the position of the drag handle.

    • Fixed findElementNextToCoords returning incorrect nodes when the position is at a node boundary. The function now correctly identifies leaf nodes (like images, horizontal rules) by checking $pos.nodeAfter before falling back to the parent node lookup.

  45. 3.4.6

    22 Sep 2025

    Reading the note…

  46. 3.4.5

    22 Sep 2025

    Reading the note…

  47. 3.4.4

    17 Sep 2025

    Reading the note…

  48. 3.4.3

    15 Sep 2025

    Reading the note…

  49. 3.4.2

    9 Sep 2025

    Reading the note…

  50. 3.4.1

    4 Sep 2025

    Reading 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.