Navigation
Rename, hide, reorder, and extend the dashboard sidebar
The dashboard sidebar is customizable through a navigation schema: rename any item, hide most of them, reorder within a group, and add your own external links. It's edited visually in the Branding studio and stored as validated JSON.
The item catalog
Navigation is a closed catalog — you customize the items that exist, keyed by stable ids. Three groups:
| Group | Id | Default label |
|---|---|---|
| Main | main.dashboard | Dashboard |
| Main | main.search | Search |
| Projects | projects.all | All projects |
| Projects | projects.starred | Starred |
| Projects | projects.mine | Created by me |
| Projects | projects.shared | Shared with me |
| Settings | settings.workspace | Workspace |
| Settings | settings.billing | Plans & Usage |
| Settings | settings.usage | Usage |
| Settings | settings.workspace-domains | Workspace Domains |
| Settings | settings.git | Git |
| Settings | settings.members | Team |
| Settings | settings.groups | Groups |
| Settings | settings.identity | Identity |
| Settings | settings.profile | Account Settings |
| Settings | settings.appearance | Appearance |
| Settings | settings.notifications | Notifications |
| Settings | settings.api-keys | API Keys |
| Settings | settings.integrations | Integrations |
| Settings | settings.design | Design Systems |
What you can do
Rename any item. Labels are plain text, HTML-stripped, capped at 24 characters. If you renamed a product noun in terminology, the two work together — nav renames win for the specific item.
Hide any item except the locked ones. Hiding only subtracts: an item your customers' plan or role already gates out can never be re-added by the schema.
Reorder items within their group. The Settings sidebar renders fixed sub-sections (Workspace, Members & access, Account, Connections, Design), so reordering there applies within those buckets. Moving a built-in item to a different group isn't supported yet — the schema tolerates it, but the item renders back in its home group.
Add external links — up to 8 across the whole nav. Each link needs:
- a label (24-character cap),
- an absolute
https://URL (anything else is rejected), - an icon from the allowlist:
Link,Book,LifeBuoy,Star,Globe,Home,Settings,CreditCard,Users,Zap(defaults toLink).
Point one at your status page, your docs, or your support portal.
Locked items
Three items can never be hidden, so customers always have a way home and a way to their account:
main.dashboard— Dashboardsettings.workspace— Workspacesettings.profile— Account Settings
They can still be renamed.
Fail-soft validation
The schema repairs rather than rejects: unknown ids are dropped, over-cap links are dropped, over-long labels are truncated, and locked items are always put back. Only a structurally unusable payload is refused. A partially wrong schema still renders — nothing you do here can blank the sidebar.