umbraco-tree-item

Implement custom Umbraco backoffice tree items with dynamic icons and labels.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanist/umbraco_CLI --skill umbraco-tree-item-albanist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-tree-item
Source: https://github.com/albanist/umbraco_CLI/tree/main/skills/extensions/umbraco-tree-item
Command: npx skills add https://github.com/albanist/umbraco_CLI --skill umbraco-tree-item-albanist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows for the customization of how entities are displayed within the Umbraco backoffice's tree structures, enabling tailored visual representations and behaviors for specific entity types.

Core Features & Use Cases

  • Custom Icons: Dynamically set icons based on item state or entity type.
  • Custom Labels/Badges: Display additional information directly within the tree.
  • Specialized Rendering: Implement unique behaviors for specific entity types in the tree.
  • Use Case: Enhance the Umbraco content tree by displaying a custom icon next to each document type that indicates its publication status (e.g., a green dot for published, a red dot for unpublished).

Quick Start

Use the umbraco-tree-item skill to create a basic manifest for a new tree item that targets the 'my-entity-type' entity.

Frequently Asked Questions about umbraco-tree-item

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

FAQPage Schema
How do I customize Umbraco backoffice tree item rendering for specific entity types?

To customize Umbraco tree items, you implement an extension manifest and integrate with the controller API to define dynamic icon logic, custom labels, and specialized rendering behaviors for your specific entity types.

Can I display dynamic icons in the Umbraco content tree based on publication status?

Yes, you can display dynamic icons in the Umbraco content tree by implementing custom tree items that dynamically set icons based on item state, such as showing a green dot for published documents and a red dot for unpublished ones.

What is an Umbraco extension manifest and when do I need it for tree items?

An Umbraco extension manifest is a configuration file required to register custom tree items within the backoffice. You need it when you want to enhance entity rendering by adding custom labels, badges, or unique rendering behaviors to the tree.

How do I add custom labels or badges to entities in the Umbraco backoffice tree?

You add custom labels or badges to Umbraco backoffice tree entities by creating a custom tree item implementation that specifies additional information to be displayed directly within the standard tree structure.

Does customizing Umbraco tree items require controller API integration?

Yes, customizing Umbraco tree items requires controller API integration to support dynamic icon logic, custom labels, and specialized behaviors for defined entity types within the backoffice extension manifest.