ueberdosis/tiptap · error · Error

Please use the NodeViewWrapper component for your node view.

Error message

Please use the NodeViewWrapper component for your node view.

What it means

Error "Please use the NodeViewWrapper component for your node view." thrown in ueberdosis/tiptap.

Source

Thrown at packages/react/src/ReactNodeViewRenderer.tsx:250

      as,
      className: `node-${this.node.type.name} ${className}`.trim(),
    })

    this.editor.on('selectionUpdate', this.handleSelectionUpdate)
    this.updateElementAttributes()
    this.currentPos = this.getPos()
  }

  /**
   * Return the DOM element.
   * This is the element that will be used to display the node view.
   */
  get dom() {
    if (
      this.renderer.element.firstElementChild &&
      !this.renderer.element.firstElementChild?.hasAttribute('data-node-view-wrapper')
    ) {
      throw Error('Please use the NodeViewWrapper component for your node view.')
    }

    return this.renderer.element
  }

  /**
   * Return the content DOM element.
   * This is the element that will be used to display the rich-text content of the node.
   */
  get contentDOM() {
    if (this.node.isLeaf) {
      return null
    }

    return this.contentDOMElement
  }

  /**

View on GitHub (pinned to 496d53afd7)

When it happens

Trigger: Thrown at packages/react/src/ReactNodeViewRenderer.tsx:250 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ueberdosis/tiptap@496d53afd7 (2026-08-26). Data as JSON: /api/errors/feb11714210521f4. Report an issue: GitHub.