Packages

@tiptap/extension-unique-id

3.34.0 · 13 Nov 2026MIT841.7k / weekRepositoryHomepagenpmAtom feed

Your version

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

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

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

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

  4. 3.17.1

    24 Jan 2026
    • Fixed markdown serialization doubling newlines and parsing collapsing multiple blank lines

    • Fixed markdown serialization doubling newlines and parsing collapsing multiple blank lines

    • Fixed markdown HTML parsing when window object is unavailable in server-side environments

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

  6. 3.16.0

    20 Jan 2026
    • Improved findDuplicates helper performance from O(n²) to O(n) by using Set-based lookups instead of Array.indexOf

  7. 3.15.3

    7 Jan 2026
    • Fix Safari scrolling to top when using editor.chain().focus() commands

  8. 3.15.2

    7 Jan 2026
    • Prevent auto-linking of bare hostnames (e.g., localhost) and IP addresses without a protocol prefix

    • Fix lost HTML attributes in TaskItem node view updates

    • Fix Vue prop validation warning for appendTo prop in BubbleMenu and FloatingMenu

  9. 3.15.1

    6 Jan 2026
    • Add a new shouldShow callback to the Suggestion utility. This allows developers to filter when suggestions are displayed, which is especially useful for collaborative environments to prevent suggestions from popping open for remote users.

  10. 3.15.0

    5 Jan 2026
    • 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.

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

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

  13. 3.12.1

    3 Dec 2025
    • Fixed a bug that mutated the ProseMirror document during server-side rendering, which could cause "Invalid content for node doc" errors.

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

  15. 3.11.1

    27 Nov 2025
    • Improve TypeScript generics for Node.extend

      The Node.extend method's TypeScript signature was updated so that ExtendedConfig can extend NodeConfig and MarkConfig,
      improving type inference when extending Node and Mark classes with additional config properties.

      This is a type-only change — there are no runtime behavior changes.

    • Fixed a bug where the TrailingNode extension would not use the node option to assume the default node type

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

  17. 3.10.8

    18 Nov 2025
    • Fixed a bug that caused extra characters to be inserted after a parsed, nestable content block by accounting for leading newlines

    • Add documentation comments to Tiptap JSON types

    • Allow undefined as a value for the default attribute key

  18. 3.10.7

    12 Nov 2025
    • Fix BubbleMenu plugin registration not triggering due to missing element reference during component initialization.

  19. 3.10.6

    12 Nov 2025
    • Fix BubbleMenu and FloatingMenu component runtime errors in Vue 2.

  20. 3.10.5

    10 Nov 2025
    • Fixed infinite transaction loop that caused browser tabs to freeze when using UniqueID and TrailingNode extensions together.

  21. 3.10.4

    8 Nov 2025
    • Fix autofocus behavior to prevent unwanted scrolling when disabled

    • Fixed nested blockquote markdown serialization to properly handle multi-level nesting

  22. 3.10.3

    7 Nov 2025
    • Fix markdown serialization to prevent marks from continuing after hard breaks. Previously, marks like bold would incorrectly persist across hard breaks in the markdown output.

    • Fixed a bug where marks were resolved in incorrect orders, breaking markdown rendering for nested marks.

    • Fix parsing of mixed bullet lists and task lists. Previously, Marked.js would group consecutive bullet list items and task list items into a single list token, causing incorrect parsing. Now the parser detects mixed lists and splits them into separate bulletList and taskList nodes.

  23. 3.10.2

    5 Nov 2025
    • Fix parsing of mixed inline HTML within Markdown content so that inline HTML fragments are parsed correctly.

    • Allow setting custom table widths by respecting user-provided style attributes instead of always overriding them with calculated widths.

  24. 3.10.1

    30 Oct 2025
    • Use correct ResizableNodeView class name

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

  26. 3.9.1

    29 Oct 2025
    • Add a renderWrapper option to the Table extension so consumers can customize whether the table wrapper for the resizable node view should be rendered in non-editable mode as well.

  27. 3.9.0

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

  28. 3.8.0

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

  29. 3.7.2

    16 Oct 2025
  30. 3.7.1

    15 Oct 2025
    • Removed

      Remove invalid server configuration from package.json

    • Editors will not throw an error anymore when content is an empty string and contentType is markdown

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

  32. 3.6.7

    14 Oct 2025
    • Security

      Fix CVE-2025-61927 by bumping happy-dom to 20.0.0

      Bumps the transitive/dev dependency happy-dom from ^18.0.1 → ^20.0.0 in @tiptap/html to address CVE-2025-61927. This is a dependency/security-only change and does not modify any public APIs.

      Why:

  33. 3.6.6

    9 Oct 2025
    • Fixed a problem where the position of a menu is not updated on creation when shouldShow is true

    • Fixed a problem where the position of a menu is not updated on creation when shouldShow is true

    • Fixed a bug that caused conditionally rendered bubble menus not to be attached to the DOM correctly

  34. 3.6.5

    3 Oct 2025
    • Added nextNodeType option to horizontal-rule extension, allowing users to specify which node type should be inserted after a horizontal rule

    • Editors can now emit transaction and update events before being mounted.
      This means smoother state handling and instant feedback from editors, even when they're not in the DOM.

  35. 3.6.4

    3 Oct 2025
    • Clean up happy-dom window instance fixing a memory leak caused by unclosed happy-dom windows

  36. 3.6.3

    2 Oct 2025
    • Updated the React FloatingMenu plugin hook dependencies to match the BubbleMenu behavior.
      The FloatingMenu will now respond to changes in appendTo, pluginKey, shouldShow, and options.

    • Resolved an issue where the React BubbleMenu did not update when FloatingUI option props changed after initial mount. The BubbleMenu now correctly responds to updated option props.

    • Improved the BubbleMenu's usability by ensuring the appendTo prop passed to the React BubbleMenu component is now correctly forwarded to the underlying bubble menu plugin. This fix allows developers to customize where the BubbleMenu is attached in the DOM, helping resolve issues with positioning and portal setups in React apps.

  37. 3.6.2

    29 Sep 2025
    • Fix a bug where the bubble menu could throw an error if the editor was destroyed
      while the plugin was cleaning up.

  38. 3.6.1

    25 Sep 2025
    • Hotfix: Fix a crash in the React package that could occur during mounting/unmounting when the editor wasn't fully initialized. This prevents a runtime error and improves stability.

  39. 3.6.0

    25 Sep 2025
    • Create a utility to add unique IDs to a document in the server

      The utility is called generateUniqueIds and is exported from the @tiptap/extension-unique-id package.

      It has the same functionality as the UniqueID extension, but without the need to create an Editor instance. This lets you add unique IDs to the document in the server.

      It takes the following parameters:

      It returns the updated Tiptap JSON document, with the unique IDs added to the nodes.

  40. 3.5.3

    25 Sep 2025
    • Merge nested span styles only for immediate child spans and guard style values.

      This change fixes a bug that could cause exponential work when parsing deeply
      nested <span> elements - in extreme cases that could make the tab unresponsive
      or crash the renderer. It is a bugfix / performance improvement with no public API
      changes.

  41. 3.5.2

    24 Sep 2025
    • Tiptap will now correctly insert a React MarkViews' content into the correct element within MarkViewContent component

  42. 3.5.1

    23 Sep 2025
    • Add appendTo support to FloatingMenu and pass it through in React/Vue 2/Vue 3 for both BubbleMenu and FloatingMenu to allow fixing clipping/z-index issues.

    • Add appendTo support to FloatingMenu and pass it through in React/Vue 2/Vue 3 for both BubbleMenu and FloatingMenu to allow fixing clipping/z-index issues.

    • Add appendTo support to FloatingMenu and pass it through in React/Vue 2/Vue 3 for both BubbleMenu and FloatingMenu to allow fixing clipping/z-index issues.

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

  44. 3.4.6

    22 Sep 2025
    • Added support for the undoable option in InputRules (matching ProseMirror’s implementation).

      This brings Tiptap’s InputRules behavior in line with ProseMirror and gives developers finer control over undo functionality.

  45. 3.4.5

    22 Sep 2025
    • Fix an issue where injected CSS was not mounted correctly when the editor instance was mounted. The fix ensures CSS injected by the editor is attached to the document when the editor mounts, preventing missing styles in some mount/unmount scenarios.

    • Use a named import for Suggestion from @tiptap/suggestion to avoid bundler ESM/CJS interop
      wrapping (__toESM) that caused Jest/CJS consumers to receive a module object instead of the
      callable plugin factory.

      This is a non-breaking internal fix. It keeps runtime module shape stable for CommonJS (Jest)
      and prevents the TypeError thrown when the extension attempted to call a non-function.

  46. 3.4.4

    17 Sep 2025
    • Fix bug in insertContentAt command where extra content would get deleted when the selection was at the beginning of the document and a node was inserted

  47. 3.4.3

    15 Sep 2025
    • When the editor view is created, it now will also include nodeViews and markViews properties instead of setting them afterward. This avoids serialization of the editor state to HTML which will be replaced by node views anyway.

    • Add custom positioning support to the BubbleMenu.

      This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.

    • Add custom positioning support to the BubbleMenu.

      This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.

  48. 3.4.2

    9 Sep 2025
    • Listen to a custom scroll target when positioning the BubbleMenu and
      ensure the scroll listener is cleaned up on destroy.

      The BubbleMenu now accepts an optional scrollTarget option which will be
      used instead of window when listening for scroll events that affect the
      menu positioning. The plugin also removes the scroll listener during
      cleanup.

      No user-facing API changes other than the new optional scrollTarget setting.

  49. 3.4.1

    4 Sep 2025
    • Prefer the raw inline style attribute when parsing color and
      background-color so the original format (hex, rgba/hsla, etc.) is
      preserved instead of falling back to the computed element.style.*
      value (which often resolves to rgb(...)).

      This fixes mismatches where consumers (for example, demo toolbars and
      color pickers) expected the original hex values when initializing the
      editor from HTML.

      MIGRATION NOTES

    • @types/react version mismatch

    • Previously, clientRect was only obtained through decorationNode. If decorationNode could not be obtained, clientRect was set to null, which caused the suggestion not to render in some IME scenarios (notably Chinese IME).

      This change adds a fallback method to compute clientRect from the editor's cursor position when decorationNode is not available. It generates a DOMRect based on the cursor coordinates so the suggestion can render even when the decoration node is missing.

  50. 3.4.0

    4 Sep 2025
    • Add mount and unmount events to the Editor instance for tracking mounts and unmounts

    • Fix can().toggleMark() returning incorrect result when cursor is inside nodes that disallow marks

      Fixed an issue where can().toggleMark('bold') incorrectly returned true when the cursor was positioned inside a code block (with no selection), even though marks are not allowed in code blocks. The method now correctly returns false in this scenario by checking if the parent node allows the mark type when the selection is a cursor.

    • Updated DropcursorOptions.color types to use types defined in prosemirror-dropcursor

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.