Features

Easy C# Configuration

Define it all using C#!

  • Tree Group Name (Subsection Menu)

  • Allowed Sections & Menus

  • Entity Types

No Manifest File

No package.manifest or lang/lang.xml files are required to get a custom tree up and running.

Versions

Umbraco icon
Umbraco CMS 15

15.0.0

Version 15 Support Policy

Feature updates until 14/08/2025
Security updates until 14/11/2025
Umbraco icon
Umbraco CMS 16

16.0.0

Version 16 Support Policy

Feature updates until 12/03/2026
Security updates until 12/06/2026

Readme

Quick Start

Install Package

dotnet add package Umbraco.Community.SimpleTrees

Register Tree

By default, this will display in the content section.

ExampleTree.cs
using Umbraco.Cms.Core.Models;
using Umbraco.Community.SimpleTrees.Models;
namespace Umbraco.Community.SimpleTrees.TestSite.Trees;
public class MyTree : SimpleTree
{
public override Task<PagedModel<ISimpleTreeItem>> GetTreeRootAsync(int skip, int take, bool foldersOnly)
{
var data = new List<ISimpleTreeItem>
{
CreateRootItem("James", Guid.NewGuid().ToString(), "icon-user"),
CreateRootItem("Tim", Guid.NewGuid().ToString(), "icon-user"),
};
return Task.FromResult(new PagedModel<ISimpleTreeItem>(data.Count, data));
}
public override Task<PagedModel<ISimpleTreeItem>> GetTreeChildrenAsync(string entityType, string parentUnique, int skip, int take, bool foldersOnly) => Task.FromResult(EmptyResult());
public override string Name => "My Tree";
}

Create Views

  • Your views must go in /Views/Trees
  • You views must be the name of your tree entities
    • For example: MyTree.cs => /Views/Trees/MyItem.cshtml & /Views/Trees/MyRoot.cshtml
Views/Trees/MyItem.cshtml
@inherits Umbraco.Community.SimpleTrees.Web.SimpleTreeViewPage
<uui-box headline="This is a custom tree item">
<div>
<table>
<thead>
<tr>
<th>Entity Type</th>
<th>Unique</th>
</tr>
</thead>
<tbody>
<tr>
<td>@Model.EntityType</td>
<td>@Model.Unique</td>
</tr>
</table>
</div>
</uui-box>

Contributing

Contributions to this package are most welcome! Please visit the Contributing page.

Acknowledgements (Thanks)