ueberdosis/tiptap · error · Error

[tiptap error]: Unsupported DomOutputSpec type, check the `r

Error message

[tiptap error]: Unsupported DomOutputSpec type, check the `renderHTML` method output or implement a node mapping

What it means

Error "[tiptap error]: Unsupported DomOutputSpec type, check the `renderHTML` method output or implement a node mapping" thrown in ueberdosis/tiptap.

Source

Thrown at packages/static-renderer/src/pm/html-string/html-string.ts:97

          return () => `<${tag}${serializeAttrsToHTMLString(attrs)}></${tag}>`
        }
        return () => `<${tag}${serializeAttrsToHTMLString(attrs)}/>`
      }
      if (children === 0) {
        return child =>
          `<${tag}${serializeAttrsToHTMLString(attrs)}>${serializeChildrenToHTMLString(child)}</${tag}>`
      }

      return child =>
        `<${tag}${serializeAttrsToHTMLString(attrs)}>${[children]
          .concat(rest)
          .map(a => domOutputSpecToHTMLString(a)(child))
          .join('')}</${tag}>`
    }
  }

  // TODO support DOM elements? How to handle them?
  throw new Error(
    '[tiptap error]: Unsupported DomOutputSpec type, check the `renderHTML` method output or implement a node mapping',
    {
      cause: content,
    },
  )
}

/**
 * This function will statically render a Prosemirror Node to HTML using the provided extensions and options.
 *
 * Limitations: this function builds the schema and runs each extension's
 * `renderHTML`, but does not instantiate an `Editor`. Extensions that mutate
 * the document inside `addProseMirrorPlugins`, `onCreate`, or transaction
 * hooks will not run. For UniqueID, pre-process the JSON with
 * `generateUniqueIds` from `@tiptap/extension-unique-id`; for TableOfContents,
 * pre-process with `generateTocIds` from `@tiptap/extension-table-of-contents`.
 *
 * @param content The content to render to HTML

View on GitHub (pinned to 496d53afd7)

When it happens

Trigger: Thrown at packages/static-renderer/src/pm/html-string/html-string.ts:97 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/ec5c79abe03358ce. Report an issue: GitHub.