umbraco-tiptap-toolbar-extension

Implement Tiptap toolbar extensions with custom controls in Umbraco's rich text editor.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-tiptap-toolbar-extension-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-tiptap-toolbar-extension
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/umbraco-tiptap-toolbar-extension
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-tiptap-toolbar-extension-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of extending Umbraco’s rich text editor toolbar by adding custom Tiptap-powered buttons, menus, color pickers, or style selectors that execute editor commands.

Core Features & Use Cases

  • Toolbar extension UI: Create toolbar items of kind button, colorPickerButton, menu, or styleMenu with labels/icons and metadata.
  • Editor command execution: Implement an execute(editor?) method that focuses the editor and runs Tiptap chain commands (e.g., toggle bold, toggle highlight, set paragraph/headings).
  • Active and disabled state behavior: Override isActive(editor?) and isDisabled(editor?) to correctly reflect the current selection state in the toolbar.
  • Modal-driven actions: Open Umbraco backoffice modals from a toolbar item to collect user input (e.g., link URL) and then apply it to the editor.

Quick Start

Ask the agent to implement a complete Umb.Tiptap toolbar extension that adds a Bold button and a Headings menu for a specified Tiptap extension alias.

Frequently Asked Questions about umbraco-tiptap-toolbar-extension

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a custom button to the Umbraco Tiptap rich text editor toolbar?

To add a custom button to the Umbraco Tiptap rich text editor toolbar, you create a toolbar extension of kind `button` and register it via manifest, then implement an `execute(editor?)` method to run Tiptap chain commands.

How do I add color pickers and dropdown menus to the Umbraco backoffice rich text editor?

You can add color pickers and dropdown menus to the Umbraco backoffice rich text editor by registering toolbar items of kind `colorPickerButton` or `menu` with labels and icons to apply styles or classes to the selected text.

How does a Tiptap toolbar extension reflect the active formatting state of the current selection?

A Tiptap toolbar extension reflects the active formatting state by overriding the `isActive(editor?)` and `isDisabled(editor?)` methods, which evaluate the editor's current selection to update the toolbar control's appearance and behavior.

Can I open an Umbraco backoffice modal from a Tiptap toolbar item to collect user input?

Yes, you can open an Umbraco backoffice modal directly from a Tiptap toolbar item to collect user input such as a link URL, and then apply the collected data to the editor by executing the appropriate Tiptap chain commands.

What do I need to implement a custom Tiptap style selector in Umbraco?

To implement a custom Tiptap style selector in Umbraco, you need to register a toolbar item of kind `styleMenu` via a manifest and use API classes that execute editor chains to apply specific classes or styles to the selected content.

Does extending the Umbraco Tiptap toolbar require specific editor API classes for command execution?

Yes, extending the Umbraco Tiptap toolbar requires API classes that execute Tiptap editor chains, ensuring the editor is focused and commands like toggling bold or setting headings are properly applied to the active selection.