
Umbraco Tree Item
This handles tree item rendering in Umbraco's backoffice navigation. You'll use it when building custom entity types that need to appear in sidebar trees, though most of the time you can stick with `kind: 'default'` and skip writing custom contexts entirely. Only bother with a custom context if you need dynamic icons, badges, or special click behaviors. The skill emphasizes fetching fresh docs first (trees in Umbraco 14+ work differently than older versions) and provides minimal working examples for both basic manifests and custom contexts extending UmbDefaultTreeItemContext. Keep tree items lightweight since they can multiply quickly in large content trees.
- skills.sh installs
- 387
- GitHub stars
- 27
- last updated
- Aug 21, 2026
Install
$ npx -y skills add umbraco/umbraco-cms-backoffice-skills --skill umbraco-tree-item --agent claude-codeInstalls into .claude/skills of the current project.
Files
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/extend-your-project/backoffice-extensions/extending-overview/extension-types/tree
- Foundation: https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/foundation
- Extension Registry: https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/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
Sponsors
Details
- Repository
- github.com/umbraco/umbraco-cms-backoffice-skills
- Categories
- Documentation, .NET & C#
- First seen
- Jun 3, 2026
More from umbraco/umbraco-cms-backoffice-skills
All 76- Umbraco Skill Validator386
- Umbraco Tiptap Extension386
- Umbraco Theme385
- Umbraco Workspace385
- Umbraco Playwright Testhelpers384
- Umbraco Skill Test Runner384
- Umbraco State Management384
- Umbraco Example Generator383
- Umbraco Skill Code Analyzer383
- Umbraco User Profile App383
- Umbraco Mocked Backoffice382
- Umbraco Tiptap Statusbar Extension382
- Umbraco Tiptap Toolbar Extension382
- Umbraco Validation Checks382
- Umbraco Ufm Component381
- Umbraco Validation Context381
- Umbraco E2e Testing380
- Umbraco Msw Testing379
- Umbraco Unit Testing374
- Umbraco Test Builders370
- Umbraco Testing368
- Umbraco Backoffice447
- Umbraco Controllers418
- Umbraco Dashboard418