Components

Tiptap Editor

TiptapEditor provides a rich-text editing surface with a configurable toolbar and structured JSON output.

Basic Usage

Use a focused toolbar for the default writing experience and keep the editor controlled so value changes stay in sync with the surrounding form.

Expanded Toolbar

Use a broader toolbar when the editor is the primary authoring surface and needs headings, tables, links, code, and undo or redo support.

Grouped Toolbar

The toolbar prop accepts a JSON array of buttons, separators ("|"), and group objects. Groups use a preset (or custom items) to open a Craft-style dropdown cluster.

Built-in presets:

PresetMenu contents
formattingParagraph, heading levels, blockquote, and code block
headingsHeading levels only
listsUnordered and ordered list
alignLeft, center, right, and justify

formatting and headings accept optional headingLevels (e.g. [1, 2, 3, 4]). When omitted, levels default to 14.

You can also pass a group with custom items instead of a preset, or mix presets with standalone buttons and separators in the same toolbar.

Edit this page
Last updated: Jul 19, 2026, 4:42 PM