HowToMoodle BlogSubscribe to our Blog

How to make use of the Custom menu feature in Moodle

by Gemma Mellings on | Oct 01, 2013 | Moodle Tips, Moodle | 0 comments

Does your Moodle site make use of the great Custom Menu feature available in Moodle 2.0 and later versions?

It allows you to set up dropdown menus that display across the top of a Moodle page. The menu links can be set to open any location on the Moodle site such as a study skills area (created as a Moodle course that permits guest access), a course listing etc. Alternatively the menu can link to external web resources. All themes provided with Moodle 2.x support this custom menu, as do a large proportion of those in the Plugins database on

How to setup a Custom Menu 

  • As an administrator, go to Administration > Site administration > Appearance > Themes > Theme Settingsand scroll down to the Custom Menu Items field.
  • Enter one custom menu item per line into the field. Each custom menu item must contain, at least, two elements. The first is the label text to display to users and the second is the URL to point them towards. The two elements are separated by a vertical line, or “pipe”, formed by typing Shift + \
    For example:
custom menu entry 1
  • The custom menu would then show the following clickable link: custom menu display 1


How to add drop-down items to a custom menu 

  • You can add drop-down items to a custom menu by proceeding items by a number of hyphens (-). The number of hyphens determines the depth of each item.
  • Items that are NOT preceded by a hyphen appear on the top level of the menu (always visible). Items with a single hyphen appear on a drop down menu below the top level item. Those with two hyphens appear on a drop down menu below the previous first level item and so on.
  • In this example, the URL for each item points to a guest-access area (course) within the same Moodle site:Workplace Resources|
  • If you have followed these steps correctly you would end up with a custom menu looking similar to this:custom menu display 2

How to add Tool Tips in a custom menu

  • A Tooltip is an optional custom menu feature for those who want it, which displays when the mouse is hovered over the item. A tooltip is useful for displaying larger titles or for giving item descriptions.
  • To enter a tooltip, just add a “pipe” (Shift+\) after the items’ URL and then type the text to display. For example:Training||Instructions, guides and help
  • If you have followed these steps correctly you should end up with a menu looking similar to this when you hover your mouse over the item:custom menu tooltip

Note: If you do not set a tooltip then Moodle uses the Label instead.

What Next

If you need help with your Moodle site simply get in touch with our friendly team of experts. We want to learn about your requirements. Call us on 0330 660 1111 or contact us via

Happy Moodling!

Expert Technical Support for your Moodle or Totara Learn site

Share this: