Table of Contents


Understanding Feature Menu Items

A Feature Menu Item is a Menu Item that Magentrix creates and manages automatically when you configure a feature in your portal. Examples include the Training menu (created when LMS is enabled), the Articles menu (created when Article Types are configured), the Reports menu, and many others. They give end users a consistent, always-current entry point to their available features without manual configuration.

Feature Menu Items appear in the App editor tree alongside Menu Items that you create yourself, but they are flagged as standard (system-managed) and behave differently.


How Feature Menu Items Differ from Custom Menu Items

CapabilityCustom Menu ItemFeature Menu Item
Created byAdministratorPlatform feature
Edit Name, URL, fieldsYesNo (read-only in editor drawer)
Move and reorder in treeYesYes
Place inside a folderYesYes
DeleteYesNo (Delete action is hidden)
Per-item sharing (Roles/Groups)Web and Link onlyNot applicable - visibility follows feature permission

How Visibility Works

A Feature Menu Item appears in a user's navigation only when the user's security role has access to the underlying feature. There is no per-item sharing dialog; the role's feature permissions control everything. For example:

  • A user whose role has Training feature access sees the Training Feature Menu Item.
  • A user whose role does not have Training feature access does not see the Training Feature Menu Item, even if it is part of an App they otherwise see.

This is intentional - it means administrators do not need to update menu sharing every time a role is granted or removed access to a feature.


What You Can Customize

Although the Feature Menu Item itself is read-only, you can:

  • Move it to a different position in the App tree by dragging.
  • Place it inside a folder to group it with related items.
  • Set the App's Default Menu Item to a Feature Menu Item if appropriate (for example, set Training as the landing item for a Training-focused App).

Use Cases

  • Group all Knowledge features. Place Articles, Wikis, FAQ, and Training Feature Menu Items inside a single "Knowledge" folder for a cleaner top-level navigation.
  • Lead with the most-used feature. Set the Reports Feature Menu Item as the App's Default Menu Item for an internal Operations App.
  • Nest reporting under Analytics. Create a custom Folder named "Analytics" and move the Reports and Dashboards Feature Menu Items into it alongside a custom Web item that embeds an external dashboard.

Troubleshooting

  • Symptom: A Feature Menu Item is missing from an App you expected.
    Cause: The corresponding feature has not been configured for the portal, or no role with access to the App has the feature permission.
    Resolution: Configure the feature first; the Menu Item appears automatically. To grant a role access, update the role's feature permissions.
  • Symptom: Edit fields are read-only on a Menu Item.
    Cause: The item is a Feature Menu Item.
    Resolution: Feature Menu Items cannot be renamed or have URLs changed. Use a custom Link Menu Item alongside or in place of the Feature item if you need a custom destination.
  • Symptom: Feature Menu Item disappears after a release.
    Cause: The feature was renamed or restructured by the platform; the system regenerates Feature Menu Items on a release boundary.
    Resolution: Locate the new Feature Menu Item in the App tree, drag it into the position or folder you want, and save.
  • Symptom: Some users do not see a Feature Menu Item even though their App is correct.
    Cause: Their role does not have access to the underlying feature.
    Resolution: Update the role's feature permissions. Per-item sharing is not the right tool for Feature Menu Items.

<< Sharing Menu Items | Navigation Menu and Security Integration >>

Last updated on 5/3/2026

Attachments