Security, limitations and troubleshooting
Keep permissions separate from visibility and resolve ordering, icon and missing-item issues.
Guides in this workflow
Follow the guide that matches the exact action, filter, menu change or issue.
Understand why menu visibility is not permission
A disabled menu entry is hidden from navigation but the module does not revoke route or record permissions.
Understand unsupported label and URL editing
The supplied builder cannot rename labels or change destination URLs.
Understand unsupported arbitrary menu creation
The module edits existing runtime items and cannot create a new destination.
Understand the absence of client-portal menu control
Only the administrator sidebar and Setup Menu filters are registered.
Understand unsupported audit, import, export and user preview
No module activity log, configuration import/export or preview-as-user workflow is implemented.
Understand unsupported automation and integrations
No cron, API or webhook is registered.
Understand option persistence after deactivation
The supplied source registers activation but no deactivation/uninstall cleanup hook.
Troubleshoot a missing menu item
Core permission, module activation, saved disabled state or stale runtime registration may hide it.
Troubleshoot a menu icon that does not render
The class may be invalid or unsupported by the CRM Font Awesome version.
Troubleshoot an item that returns after saving
New runtime items absent from saved JSON are appended, and protected items cannot be disabled.
Troubleshoot menu order after module updates
Removed items are ignored and newly added items are appended, which can change the visible order.
Verify CRM Menu Builder after deployment
Run a controlled Main Menu and Setup Menu change/reset test.