umbraco-extension-registry

Manage Umbraco backoffice UI extensions via the umbExtensionsRegistry.

26|13|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-extension-registry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-extension-registry
Source: https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills/tree/main/plugins/umbraco-backoffice-skills/skills/umbraco-extension-registry
Command: npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-extension-registry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers understand and manipulate the Extension Registry, the core system for managing UI elements in the Umbraco backoffice, enabling dynamic customization of the interface.

Core Features & Use Cases

  • Extension Management: Register, exclude, unregister, and replace UI extensions.
  • Dynamic Customization: Modify backoffice UI elements at runtime based on specific conditions or server data.
  • Use Case: You need to hide a default Umbraco dashboard and replace it with a custom one that only appears for content editors.

Quick Start

Use the umbraco-extension-registry skill to register a new dashboard extension.

Frequently Asked Questions about umbraco-extension-registry

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

FAQPage Schema
How do I register a custom UI extension in the Umbraco backoffice?

To register a custom UI extension in the Umbraco backoffice, you use the `umbExtensionsRegistry` to dynamically add and configure new interface elements. This approach enables tailored backoffice customization at runtime.

How does the Umbraco extension registry handle dynamic UI customization?

The Umbraco extension registry manages dynamic UI customization by allowing runtime registration and conditional display of backoffice elements. It uses the `umbExtensionsRegistry` to modify or replace default interfaces based on specific server data or conditions.

Can I hide or replace a default Umbraco dashboard for specific user groups?

Yes, you can hide or replace a default Umbraco dashboard for specific user groups by excluding the default extension and registering a custom one. The `umbExtensionsRegistry` supports conditional UI customization based on user roles.

What is the difference between excluding and unregistering an Umbraco backoffice extension?

Excluding an Umbraco backoffice extension temporarily prevents it from loading, while unregistering completely removes it from the `umbExtensionsRegistry`. Excluding is useful for conditional scenarios, whereas unregistering permanently drops the UI element.

Does Umbraco extension management require TypeScript?

Umbraco extension management heavily relies on TypeScript for defining and manipulating backoffice UI extensions. Developers interact with the `umbExtensionsRegistry` using TypeScript to ensure type-safe dynamic customization.

When should I replace an existing backoffice extension instead of creating a new one?

You should replace an existing backoffice extension instead of creating a new one when you need to override default Umbraco behavior in place. Using the `umbExtensionsRegistry` to replace extensions ensures the custom UI maintains the original extension's integration points.