umbraco-tree-item

Register Umbraco treeItem manifests to render custom tree node visuals.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the challenge of making Umbraco backoffice tree nodes display correctly for specific entity types, including custom icons, labels, and behavior.

Core Features & Use Cases

  • Define tree item extensions: Register treeItem manifests that map rendering to one or more entity types.
  • Add custom context when needed: Use an API context to override icon/label rendering for dynamic or specialized presentation.
  • Integrate cleanly with Umbraco tree structure: Works with existing tree definitions and repository aliases while keeping the UI consistent.

Quick Start

Fetch the official Umbraco tree-item documentation, then implement a treeItem manifest for your target entity types and optionally add a custom context module to override the icon or label.

Frequently Asked Questions about umbraco-tree-item

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

FAQPage Schema
How do I render custom Umbraco backoffice tree items for specific entity types?

To render custom Umbraco backoffice tree items, you register a treeItem extension manifest specifying the kind, alias, name, and forEntityTypes, optionally wiring an API context module to override default label and icon methods for specialized presentation.

Why are my Umbraco tree nodes displaying inconsistent or missing UI representation in the backoffice?

Inconsistent Umbraco tree node UI representation occurs when entity types lack a registered treeItem manifest mapping them to custom rendering logic, requiring a treeItem extension with an optional API context to resolve dynamic icons, labels, and badges.

Can I add dynamic icons and badges to Umbraco tree item extensions?

Yes, you can add dynamic icons, labels, and badges to Umbraco tree item extensions by wiring an optional API context module within the treeItem manifest that overrides the default icon and label rendering methods.

Do I need TypeScript to implement custom tree item context modules in Umbraco?

TypeScript is used to implement custom tree item context modules in Umbraco, allowing developers to define the API class that overrides standard label and icon methods for specialized tree navigation behavior.

What is the best way to integrate custom tree item rendering with existing Umbraco tree definitions?

The best way to integrate custom tree item rendering is registering a treeItem manifest with the correct kind and forEntityTypes mapping, ensuring it works cleanly with existing tree definitions and repository aliases while maintaining UI consistency.

When should I use a custom API context versus a standard treeItem manifest in Umbraco?

Use a standard treeItem manifest for default UI representation mapped to entity types, and add a custom API context when you need to override icon or label rendering methods for dynamic, specialized tree node presentation.