The Admin Menu Module

The Admin Menu Module allows you to edit the menu that appears on the left side of the WordPress admin screens.  

As with most of the modules, this one is based on "Views". A view is simply a saved menu configuration. You can save as many Views as you'd like.

Creating Your First Admin Menu View

  1. To get started, you'll want to name your first view by typing something into the View Name box.

  2. Then click the Save View button to save that view name to the database.
  3. Now choose the rules you want to apply to this view in the Add Rules column on the left. Learn more about adding rules here.
  4. Next, under Menu Configuration, you can edit the menu as you see fit. We go into detail about this section later in this article.
  5. You may wish to verify how your menu will look under different circumstances using the Advanced Options feature. Learn more about Advanced Options here.
  6. Finally, at the bottom of the screen you have some additional choices that affect the entire admin menu under Admin Menu Settings. We go into detail about this section later in this article.
  7. When you're ready, click Save View again.
  8. Your custom menu configuration should now appear based on the rules you've assigned to it.

Menu Configuration 

The menu configuration section displays a list of the menu items as they appear on your website.  You can edit the admin menu in the following ways:

Reorder Menu Items

Reordering menu items is as simple as dragging and dropping a menu item to a different position. If you drag the menu item slightly to the right it will become a submenu of the menu item above it.

Certain items you can't drag to certain positions because of limitations of either WordPress or the individual menu item. In such cases, the outline will turn red, indicating that action can't be completed.

Rename Menu Items

You can change the name, aka navigation label, of any menu item by simply clicking on the name. A text box will appear and you can type in anything you want. 

Certain basic HTML tags are honored in the navigation label field, such as <em> and <strong>. It's best to enter these via the "Navigation Label" box under settings by clicking the gear icon on the menu item.

Change the Icon of the Menu Item

Much like renaming a menu item, you can change the icon of the menu item by simply clicking on the icon itself.

When you do so, a box appears with icons to choose from.  Currently you can choose from the complete library of WordPress Dashicons.

You may also choose an empty box so that no icon appears.

Hide Menu Items

You can hide menu items by clicking the Eye icon. When a menu item is hidden, it will appear light gray and the eye icon will have a line through it.

Note: when you hide a top-level menu item, all of it's submenu items will be hidden by default.

Create a New Menu Item

You can click the Add Item button to add your own custom menu item.

You can create one of the following menu types:

  • Menu Item - This is a traditional menu item that links somewhere. You can then choose to either link to an external page or allow the user to log out.
  • Heading - This is a menu item that acts as a heading and doesn't link anywhere. This menu item will appear with a darker gray background to help identify it in your menu configuration.
  • Separator - This is spacer that adds some separation between menu items.

Admin Menu Settings

At the bottom of the Admin Menu View screen are the Admin Menu Settings.  These are setting that apply outside of the traditional admin menu structure.

Collapse Menu - These options affect the default menu collapse functionality.

Hide "Collapse menu" link - This allows you to completely hide the Collapse menu link that appears at the bottom of the admin menu

Display Admin Menu collapsed by default - This will show the menu collapsed by default.