Sections
Configuring sections in Umbraco UI Builder, the backoffice UI builder for Umbraco.
A section is a distinct area of the Umbraco backoffice, such as content, media, etc. The section is accessed via a link in the main menu at the top of the Umbraco interface. Umbraco UI Builder allows you to define multiple sections in order to organise the management of your models into logical sections.
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2F2282367567-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaQtFchjsM4Ce0DxWznCF%252Fuploads%252Fgit-blob-bfcea850b44e88688f15a71e5e821bea5a66a7ba%252Fsections.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=afa8d916&sv=1)
Defining a section
You can define a section by calling one of the AddSection
methods on the root level UIBuilderConfigBuilder
instance.
AddSection(string name, Lambda sectionConfig = null) : SectionConfigBuilder
Adds a section to the Umbraco menu with the given name.
AddSectionBefore(string beforeAlias, string name, Lambda sectionConfig = null) : SectionConfigBuilder
Adds a section to the Umbraco menu with the given name before the section with the given alias.
AddSectionAfter(string afterAlias, string name, Lambda sectionConfig = null) : SectionConfigBuilder
Adds a section to the Umbraco menu with the given name after the section with the given alias.
Changing a section alias
SetAlias(string alias) : SectionConfigBuilder
Sets the alias of the section.
Optional: When adding a new section, an alias is automatically generated from the supplied name for you. However, if you need a specific alias you can use the SetAlias
method to override this.
Configuring the section tree
Tree(Lambda treeConfig = null) : TreeConfigBuilder
Accesses the tree config of the current section. For more information check the Trees documentation.
Adding a dashboard to the section
AddDashboard(string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
Adds a dashboard with the given name. For more information check the Dashboards documentation.
AddDashboardBefore(string beforeAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
Adds a dashboard with the given name before the dashboard with the given alias. For more information check the Dashboards documentation.
AddDashboardAfter(string afterAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
Adds a dashboard with the given name after the dashboard with the given alias. For more information check the Dashboards documentation.
Extending an existing section
You can extend existing sections by adding Umbraco UI Builder trees and dashboards, context apps, and virtual subtrees. This can be done by calling the WithSection
method on the root level UIBuilderConfigBuilder
instance.
WithSection(string alias, Lambda sectionConfig = null) : WithSectionConfigBuilder
Starts a sub-configuration for the existing Umbraco section with the given alias.
Adding a tree to an existing section
AddTree(string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
Adds a tree to the current section. For more information check the Trees documentation.
AddTree(string groupName, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
Adds a tree to the current section in a group with the given name. For more information check the Trees documentation.
AddTreeBefore(string treeAlias, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
Adds a tree to the current section before the tree with the given alias. For more information check the Trees documentation.
AddTreeAfter(string treeAlias, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
Adds a tree to the current section after the tree with the given alias. For more information check the Trees documentation.
Adding a dashboard to an existing section
AddDashboard (string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
Adds a dashboard with the given name. For more information check the Dashboards documentation.
AddDashboardBefore (string beforeAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
Adds a dashboard with the given name before the dashboard with the given alias. For more information check the Dashboards documentation.
AddDashboardAfter (string afterAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
Adds a dashboard with the given name after the dashboard with the given alias. For more information check the Dashboards documentation.
Last updated