Navigation

The site's navigation is made of site menus, edited at Content > Site menus. (Not to be confused with page contents - the list a layout with a sidebar builds from a page's own headings, set up in Layouts and per page with [contents].) A menu is a list of links; a location (a slot) is where one is shown. Each menu is a file in config/menus/, and the slot map is config/menu-locations.json. Pages have no "show in navigation" switch - a page appears in the navbar when a menu links to it.

Locations

Plugins can add slots of their own. Pick the menu for each slot under Menu locations. A menu that a location uses cannot be deleted until it is taken out.

Editing a menu

• Items - click an item to edit its label, link, icon, badge, look and who sees it. Drag the grip to move an item: a line shows where it will land, and an outline round a row means it will go inside that row (the navbar shows nested items as a dropdown, the admin sidebar as a folder inside a folder). Press Esc while dragging to cancel. On a touch screen, drag by the grip too. Right-click an item for add, move, indent, duplicate, hide and remove. Separators, spacers and the theme switcher (the site's theme dots, among the links) are items too.
• Behaviour - colour scheme, sticky, fixed, static or floating, horizontal or vertical, alignment, and the hover and current-page highlight. A single item can override the highlight in its own editor.
• Binding - let this menu take a slot over on some pages only (a project's pages, or pages matching a pattern such as /shop/*) while the menu mapped under Menu locations shows everywhere else. The most specific match wins.
• Meta - the menu's id, which is its file name and what [menu slug="..."] names.

Links

Use a site path (/about) for your own pages or a full https:// address for another site. An item with no link and sub-items is a heading. When you rename a page in the page editor, every menu link to it follows it to the new address.

Who sees an item

Each item can be limited to roles, using the same ladder as page visibility: "Member and above", or "Member only" (=member). Items a visitor may not see are left out of the page on the server. See Users & Roles.

Menus inside pages

Place any menu in a page with [menu slug="legal" /], or show whatever a slot holds with [menu location="footer-primary" /]. See Shortcodes.

The admin sidebar

The admin-sidebar menu is this sidebar. In the Menus editor you can move Tools between folders, rename them, hide them or add links of your own. Dashboard, Menus, Users and My Profile can be moved but never hidden, so you can always get back from a bad edit.

Folders can hold folders. Tools start in groups inside Tools by what they are for - Productivity, Communication, Marketing, Publishing, Business and Maintenance (a site set up before 0.103 may still have a Core group); move a Tool out of its group, or move the whole group, and your arrangement is kept. A group that nothing of yours has been saved into is not stored - it is made again when the sidebar draws, and a user who may use none of its Tools does not see it. Back to its default place on a Tool puts it back in its group. Each folder remembers whether you left it open or closed on its own, so closing Tools > Core does not close a project that is also called Core.

Counts on the sidebar

A Tool's badge shows what needs attention - unread messages, late tasks - in red when something is late. When nothing does, it shows a plain count instead of a blank: Todo the tasks done, Analytics today's page views, Booking the bookings in the next seven days, the Shop its products. Hover a badge for what it means. Those plain counts are left out of a closed folder's total, so a folder's number still only adds up what needs you.

Resize or fold the sidebar

Drag the sidebar's right edge (mouse, touch or pen) to make it wider or narrower; double-click the edge to put it back. From the keyboard, focus the edge: the arrow keys change the width (with Shift for bigger steps), Home and End go to the narrowest and widest, and Enter folds it. The chevron in the sidebar header - or dragging the edge past its narrowest - folds it to a rail of icons: hover or focus one for its name and what its count means, and click a folder to open its contents beside the rail. The width and whether it is folded are remembered in this browser.

Arrange the sidebar in place

You can also rearrange the sidebar without leaving the page you are on. Click the six-dot button at the top of the sidebar, beside the site name, to turn on Arrange. The sidebar then lists every item as a row, including hidden ones (dimmed and struck through), and clicking a row no longer opens it.

• Move - drag a row. A line shows where it will land.
• Put inside a folder - drop it on the middle of another row; an outline shows it going in. Dropping on the line just under a folder puts it at the top of that folder.
• Hide or show - the eye at the end of a row. A padlock means the item can be moved but not hidden.
• Keyboard - with a row focused, Alt+Up and Alt+Down move it, Alt+Right puts it inside the row above, Alt+Left takes it out of its folder.
• Done saves and redraws the sidebar. Cancel or Esc leaves it as it was, asking first if you moved anything.

Arrange changes the same admin-sidebar menu as the Menus editor, so it changes the sidebar for everyone; each person still sees only what their role allows. Renaming items, changing icons, badges or who can see an item, and adding links is done in the Menus editor. The button is shown to users who may edit menus.

Right-click menus on public pages are a separate feature: Content > Context Menus.