Built LMS Help Center
Settings

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

  1. Open Settings > Appearance & Navigation > Navigation.
  2. Open the Navbar tab.
  3. Select Settings.
  4. Update the settings.
  5. Select Save Settings.

Available settings:

SettingWhat it does
Show Theme ToggleShows the learner theme toggle in the navbar when the active theme supports it.
Maximum Menu DepthSets the maximum menu depth value to 1, 2, 3, or 4 levels.
Mobile BreakpointChooses 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.

TypeUse it forRequired destination field
System RouteBuilt-in learner or admin routes.System Route
Page from CMSA page created under Content > Pages.Page
External URLA 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:

  1. Select Add Item.
  2. Enter Label.
  3. Choose Type.
  4. Complete the required destination field.
  5. Choose Icon or No Icon.
  6. Add Description if the item appears inside a grouped menu.
  7. Choose Parent Item if the item belongs under another navbar item.
  8. Set Opens in New Tab if needed.
  9. Set Requires Authentication, Admin Only, and Visible.
  10. 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.

  1. Select Add Item.
  2. Enter a short Label, such as Resources, Support, or Company.
  3. Choose Group (no link).
  4. Select Create.
  5. Create or edit child items.
  6. Set each child item's Parent Item to the group.
  7. 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 fieldError shown
LabelLabel is required
System route on a system itemSystem target is required
Page on a CMS page itemPage selection is required
External URL on an external itemExternal 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:

  1. Open the learner portal in a new tab.
  2. Check the desktop navbar.
  3. Check the mobile navbar at the configured breakpoint.
  4. Sign out and confirm public-only behavior.
  5. Sign in as a standard learner and confirm learner links.
  6. Sign in as an admin and confirm admin-only links.
  7. Open grouped menus and verify child links.

Troubleshooting

On this page