Configure the Learner Navbar
Create, group, reorder, hide, and secure learner navbar items.
Use the Navbar tab for the primary learner menu.
Before you begin
You need:
- Admin access to organization appearance and navigation settings.
- The learner destinations that belong in top navigation.
- Any CMS pages already created under Content > Pages.
- A decision about which items are public, signed-in only, or admin only.
Keep the menu shallow. A broad multi-level menu is usually harder for learners to scan than a short navbar plus footer links.
Configure navbar behavior
Configure navbar settings
- Open Settings > Appearance & Navigation > Navigation.
- Open the Navbar tab.
- Select Settings.
- Update the settings.
- Select Save Settings.
Available settings:
| Setting | What it does |
|---|---|
| Show Theme Toggle | Shows the learner theme toggle in the navbar when the active theme supports it. |
| Maximum Menu Depth | Sets the maximum menu depth value to 1, 2, 3, or 4 levels. |
| Mobile Breakpoint | Chooses when the navbar switches to mobile behavior: Small, Medium, Large, or Extra Large. |
Add and organize items
Create navbar items
Each navbar item has one required Type.
| Type | Use it for | Required destination field |
|---|---|---|
| System Route | Built-in learner or admin routes. | System Route |
| Page from CMS | A page created under Content > Pages. | Page |
| External URL | A destination outside Built LMS. | External URL |
| Group (no link) | A parent item that groups child links but does not navigate. | None |
To create an item:
- Select Add Item.
- Enter Label.
- Choose Type.
- Complete the required destination field.
- Choose Icon or No Icon.
- Add Description if the item appears inside a grouped menu.
- Choose Parent Item if the item belongs under another navbar item.
- Set Opens in New Tab if needed.
- Set Requires Authentication, Admin Only, and Visible.
- Select Create.
Most learner navbars should use learner routes. If you add an admin route, turn on Admin Only so the item is hidden from standard learners.
Create groups and reorder items
Use Group (no link) when the top-level item should organize child links instead of linking anywhere.
- Select Add Item.
- Enter a short Label, such as
Resources,Support, orCompany. - Choose Group (no link).
- Select Create.
- Create or edit child items.
- Set each child item's Parent Item to the group.
- Drag child items into the right order under the group.
Navbar drag-and-drop only reorders items within the same parent level. To move an item into or out of a group, edit the item, change Parent Item, save, and then drag it into the correct order among its new siblings.
Edit, hide, or delete navbar items
Use the edit icon to update label, type, destination, icon, description, parent, or visibility settings.
The editor validates required fields before saving:
| Missing field | Error shown |
|---|---|
| Label | Label is required |
| System route on a system item | System target is required |
| Page on a CMS page item | Page selection is required |
| External URL on an external item | External URL is required |
Use the eye icon to hide or show an item quickly. Use the trash icon only when the item should be removed.
Verify success
After saving navbar changes:
- Open the learner portal in a new tab.
- Check the desktop navbar.
- Check the mobile navbar at the configured breakpoint.
- Sign out and confirm public-only behavior.
- Sign in as a standard learner and confirm learner links.
- Sign in as an admin and confirm admin-only links.
- Open grouped menus and verify child links.
Troubleshooting
Check Visible, Requires Authentication, Admin Only, whether the item was created on the Navbar tab, and whether the parent item is visible.
Edit the item, change Parent Item, save, and then drag it into the correct sibling order.
Edit the navbar item and turn on Admin Only, or remove the admin route from learner navigation. Then confirm the route itself also enforces permissions.