Skip to content
Tutorials Center
My learning

Topics

Lesson 18 of 37 ยท Menus and Modules

Menu Modules, Breadcrumbs and Site Navigation

Display menus with the Joomla menu module: start and end levels, submenus, active items, breadcrumbs, footer menus and mobile navigation, with a runnable menu renderer.

You have menus full of menu items and you know modules fill positions. This lesson connects the two: the menu module that displays a menu, the settings that control its depth, the Breadcrumbs module that shows where you are, and design guidance for navigation that visitors actually find easy to use.

The backend is described in words. The stand-in renders a menu tree with start and end levels, which is the logic of the real module.

Create a menu module

Go to Content > Site Modules > New and choose the module type Menu. Set the Position (usually menu, or footer for a footer menu), choose which Menu to show, and use the Menu Assignment tab to decide on which pages it appears (normally all pages). Key options:

  • Select Menu: the menu whose items to show.
  • Base Item: show only the children of a chosen menu item (useful for section navigation). When Current is chosen, the module shows the children of the active item.
  • Start Level and End Level: which levels of the tree to render (1 is the top). Start 1 / End All renders everything; Start 2 renders only submenu items, so a sidebar can show the sub-pages of the current section.
  • Show Sub-menu Items: whether children are rendered or hidden.
  • Advanced: layout (for example the default list or a dropdown-friendly layout), CSS classes, Module Class, caching, Menu Class Suffix.

What gets marked

The module marks items with CSS classes so templates can style them: current for the exact item you are on, active for items in the path to it (the section), parent for items that have children, and deeper and level-N for nesting. You use them in CSS to highlight the current section.

Three common menu modules

Main menu Levels 1-2 in the header
Section menu Start level 2, base item current
Footer menu Utility pages like privacy

One menu can feed many modules

1 / 2

Rendering levels

flowchart TD
    A["Home"] --- B["About (level 1)"]
    B --> C["Team (level 2)"]
    B --> D["History (level 2)"]
    C --> E["Leadership (level 3)"]

A menu module with Start Level 2 and Base Item "About" shows Team and History; End Level 2 hides Leadership.

JS Stand-in: render a menu with start and end levels

Press Run (or Ctrl + Enter) to see the console output here.

No output.

The first menu marks About as active and Team as current. The second prints only second-level items, as a sidebar section menu would. Notice how level and start/end control exactly what appears.

The Breadcrumbs module (type Breadcrumbs) shows the path from the home page to the current page, for example Home / News / Company / Launch. It helps visitors orient themselves and gives search engines a hint about site structure. Typical settings: Show Home, the text for the Home link, whether the last item is shown and linked. Put it in the breadcrumbs position (Cassiopeia) and assign it to all pages except the home page.

Breadcrumbs follow the menu item path and then the component's own path (for example category and article within a blog). That is another reason to keep the menu tree meaningful.

JS Stand-in: build breadcrumbs

Press Run (or Ctrl + Enter) to see the console output here.

No output.

The last crumb is not a link (the current page). The same module also writes structured data about the trail in modern templates, which helps search results.

Create a second menu (Menus > Manage > New Menu), for instance Footer Menu, add items such as Privacy, Imprint, Contact and Cookie Settings, and show it with a menu module in the footer position. Utility links that you do not want in the main navigation belong here. Legal pages are required in many countries, so make them easy to find.

Cassiopeia's menu module renders nested lists; submenus appear as dropdowns on desktop and collapse behind a "hamburger" button on small screens (a mobile-menu behavior built into the template's JavaScript). Test on a phone: very deep menus are hard to use. A few guidelines:

  • Limit the top level to about 5 to 7 items.
  • Use at most two levels in the main menu. Use a section menu for deeper trees.
  • Use clear labels: "Pricing", not "Our Cost Structure".
  • Keep the order stable; do not rearrange menus every month.
  • Make the current section obvious by styling .active.

Hidden pages and the Menu Item Alias

Pages that should exist but not clutter the main menu go in a hidden menu with no module, or use Display in Menu: No. A Menu Item Alias allows the same page to show in the footer menu and in a section menu without duplicating options.

JS Stand-in: audit a menu for common problems

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Such audits are easy to automate, and the habit of reviewing navigation as data pays off on large sites.

Common mistakes

  • Menu items created but no menu module, so nothing appears.
  • Wrong assignment: the menu module is set to "No pages" or only certain pages.
  • Deep menus that are painful on mobile.
  • Duplicated menus (a second module that shows the same menu with different options) forgotten later.
  • Missing Home in breadcrumbs or the module showing on the home page itself.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. What do Start Level and End Level control in the menu module?

    They limit the module to a range of levels, such as only second-level items for a section menu.
  2. 2. Which CSS class marks the exact page you are on in a Joomla menu?

    current marks the exact item, active marks items in its path, parent marks items with children.
  3. 3. What does the Breadcrumbs module show?

    Breadcrumbs help orientation and can provide structured data to search engines.
  4. 4. Where does a footer menu usually live?

    Create a separate menu and display it with a menu module placed in the footer position.

Summary

  • A menu module displays a menu in a position; Start and End Levels and Base Item control the part shown.
  • The module marks items with current, active and parent classes for styling.
  • Breadcrumbs show the path to the page; footer and utility menus use separate menus and modules.
  • Keep menus short and shallow, test them on small screens and audit them regularly.
  • This completes the structure side of Joomla: articles, categories, menus and modules. Templates and extensions come next.

Next: Cassiopeia and Template Styles