Overview
Your app's navigation entries live in three separate lists. The list an entry is in decides where it renders, and each list is ordered on its own. All three are set up in Settings → Development → Navigation → Content.
List | Where it renders | What goes in it |
|---|---|---|
Menu Items | The main run of entries down a sidebar, across a top bar or along a bottom bar. | Page, module and URL entries, groups and the brand (logo) entry. A mobile app's Menu Items list accepts up to 15 entries. |
Secondary Menu Items | A separate cluster, for example at the bottom of a sidebar or the end of a top bar. Web apps only. | The ready-made Profile and Notifications entries, plus any other Nav Item. |
User menu | The dropdown that opens when a user clicks the Profile entry. | Page links, URLs, buttons, Change Language and Change Color Scheme. It exists only while a Profile entry is in Secondary Menu Items. |
Note: The standard navigation has no slots, meaning no placeholder areas you fill with your own blocks. Entries go only into these three lists. To build navigation from your own blocks, set Navigation Style to Custom at XL, LG or MD and pick your module. In a mobile app, set Navigation Style to Bottom Bar or Drawer, then click Create custom bottom bar or Create custom drawer under Styling in the Appearance tab. See Custom Navigation Module.
Adding User Menu Entries
Open Settings → Development → Navigation → Content.
In Secondary Menu Items, click the Profile entry to open its settings. If there is no Profile entry, add one with Add first.
Optionally set Profile Page, the page that opens when a user clicks their profile.
Under Menu Items, click Add and pick page links, URLs, buttons, Change Language or Change Color Scheme.
Ordering Menu Entries
Navigation entries are not generated from your pages. Reordering pages or folders in the Pages panel does not change the menu. Order is set in the Navigation settings, in two places.
Reorder in the Content Tab
Open Settings → Development → Navigation → Content.
In Menu Items or Secondary Menu Items, drag rows up or down to reorder them.
Every breakpoint you have not reordered by hand follows this order.
Reorder One Breakpoint in the Appearance Tab
Open the Appearance tab and select a breakpoint under Breakpoints.
Drag the entries in that breakpoint's list into the order you want.
Use the eye icon to hide an entry at this breakpoint only. In a web app, you can also drag an entry into the Hidden in overflow area. Either way, the entry is removed from the navigation at that breakpoint. The running app doesn't show a "More" overflow menu yet, so users can't reach that entry from the navigation.
Note: Once you drag entries at a breakpoint in the Appearance tab, that breakpoint keeps your order. Reordering in Content no longer changes it, and new entries appear at the end. Reorder that breakpoint in Appearance too.
Notification Badges
Menu entries have no badge field. The built-in Notifications entry in Secondary Menu Items shows the user's unread count, capped at "99+".
Tip: On a public app, the Profile entry and its user menu are removed from the navigation. Move anything users need from the user menu, such as a language switcher, into Menu Items or Secondary Menu Items.