Menu Editor

The Menu Editor module lets you fully customize the WordPress admin menu. Reorder items with drag-and-drop, rename titles, add separators, and hide menu items for specific user roles—making the dashboard cleaner, more intuitive, and tailored to your team or clients.

How to use

To enable the Menu Editor module:

1. Click on the “Admin Tools” category
2. Search or scroll to locate the Menu Editor module
3. Click on the switch to enable

What’s next?

This module lets you customize the WordPress admin menu:

• Reorder menus with drag-and-drop
• Hide items for specific roles
• Rename menu titles (supports HTML for badges)
• Insert separators for organization

1. Configure Menu Structure

1. Go to the module settings by clicking the “Settings” tab
2. Open “Menu Items”
3. Drag and drop items to reorder
4. Use “Add Item” where available, or edit existing items directly
5. Use “Separator” type to visually group items

Notes:

• Nesting is supported up to one level (max depth 1).
• WP Extended sub-items are de-duplicated and appear under the WP Extended parent only.

2. Rename Menu Items

1. Click a menu item to expand it
2. Menu Title:
   • Set a custom title (HTML allowed for badges/styling)
   • Leave empty to use the default title
3. Save settings

Tip:

• Use small HTML badges (e.g., “Updates 3”) to highlight items.

3. Restrict Visibility by Role

1. Expand a menu item
2. Access Restricted by Role:
   • Tick the roles that should see this item
   • Untick to hide from a role
3. Save settings

Notes:

• Role choices are auto-populated from your site’s roles.
• Dashboard (index.php) is always visible and not role-filterable in this module UI.

4. Use Separators

1. Add or change an item’s Type to “Separator”
2. Place it where you want a visual break
3. Save settings

Notes:

• Children under a “Separator” are flattened (moved up) when saved to keep the structure consistent.

5. Apply & Behavior

• Changes are applied on the admin menu load (admin_menu priority 999).
• Page access is enforced: users without access are redirected away from restricted pages (admin_init), with robust URL normalization.

6. Best Practices

• Keep critical items (e.g., Updates, Plugins) visible for Admin/Manager roles
• Use separators to group related tools for editors and authors
• Prefer renaming over hiding when users still need access but need clearer labels

7. Troubleshooting

• Changes not visible:
  • Clear caches and hard-refresh the admin
  • Confirm you saved settings and are viewing as a role affected by the change
• Wrong roles see items:
  • Re-check “Access Restricted by Role” selections
  • Verify custom roles/capabilities assigned by other plugins
• Items reappear or duplicates:
  • Some WP Extended items are intentionally consolidated under the WP Extended parent
  • Ensure there are no conflicting menu customizer plugins active

8. Compatibility & Notes

• Designed for standard WordPress admin menus
• Renames affect labels only; underlying slugs/targets remain the same
• Default capability used for items is manage_options if unspecified
• Deep nesting beyond one level is not supported by this module’s UI

This module is perfect for:

• Decluttering the admin for non-technical users
• Creating role-based admin experiences
• Organizing complex sites into logical groups