Menu Subheader | Legacy Components | Lightning Component Reference

lightning:menuSubheader

Creates a divider in the list of items for lightning:buttonMenu.

For Aura components only. For LWC development, use lightning-menu-subheader.

For Use In

Lightning Experience, Experience Builder Sites, Salesforce Mobile App, Lightning Out (Beta), Standalone Lightning App, Mobile Offline

The lightning:menuSubheader component creates a heading in the list of menu items in a lightning:buttonMenu component. The heading appears in bold text and is slightly larger than menu item text. Subheaders can help categorize items and improve usability for long lists.

Specify the text of the heading using the label attribute.

Nest lightning:menuSubheader inside lightning:buttonMenu before the lightning:menuItem where you want the header. Use lightning:menuSubheader as a sibling of lightning:menuItem, not as a child component.

This example shows a dropdown menu with subheaders.

For further customization of button menus, use lightning:menuDivider to create divider lines in the list of items. You can place dividers under subheaders or menu items.