Umbraco Tree Item

What is it?

Tree Items define how entities are rendered in tree structures throughout the Umbraco backoffice. They control the visual representation and behavior of items in sidebars and navigation trees. Tree items are associated with entity types and can be customized to display additional information, icons, or custom rendering for specific entity types.

Documentation

Always fetch the latest docs before implementing:

• Main docs: https://docs.umbraco.com/umbraco-cms/customizing/extending-overview/extension-types/tree
• Foundation: https://docs.umbraco.com/umbraco-cms/customizing/foundation
• Extension Registry: https://docs.umbraco.com/umbraco-cms/customizing/extending-overview/extension-registry

When to Use Custom Tree Item Contexts

Most tree items use kind: 'default' and don't need a custom context. Only create a custom context for:

• Custom icon logic - Dynamic icons based on item state
• Custom labels or badges - Additional visual information
• Special rendering - Unique behavior for specific entity types