Intro
The menu button is a UI component that opens a menu containing a list of related actions for the user to select from. In split mode, the menu button also supports a default action that can be triggered directly without opening the menu.
Regular menu button and split menu button
Component availability
The menu button component is available in the following libraries:
The guideline covers the menu button component. For other button types, see the Buttons Overview.
When to Use
Use the regular menu button to:
- Group related actions when there is no clear default action.
Use the split menu button to:
- Group related actions when one action is used more often than the others.
Don’t use the menu or split menu button to:
- Switch between different states. Use the toggle button or the switch instead.
- Perform individual actions that are not intended to be grouped. Use the simple button instead.
- Use regular and split menu buttons to group actions in a single menu, including items and submenus.
- Use the regular menu button to group related, equivalent actions under a single trigger.
- Use the split menu button when one action is used more often than the others.
- In split mode, describe the default action in the button text. If the default action appears as an icon only, use icons for all menu items.
- Apply button text and icon buttons guidelines to menu buttons to ensure actions are clear.
- Use the emphasized menu button for primary actions.
- Use the standard menu button for secondary actions.
- Use the transparent menu button for tertiary actions.
- Always pair icon-only menu buttons with a tooltip that labels the action.
Anatomy
The menu button component consists of the following elements:
- Background: Indicates the button state using different colors.
- Text: Describes actions triggered by the menu button or the default action of the split button type.
- Arrow: Indicates that the button opens a menu with multiple items.
- Separator: Indicates that the two areas in the split menu button trigger different actions.
Regular and split menu button anatomy
Types
There are two types of menu buttons. Both open a menu with items. These items trigger actions or open further submenus.
Menu button with opened menu (A) and split menu button with opened menu and submenu (B)
Regular
The regular menu button groups related actions under a single trigger.
Regular type
Split
The split menu button is separated into two interactive areas by a divider – the text area, which triggers the default action, and the arrow icon, which opens the menu. The split menu button combines multiple actions and highlights a primary action.
In split mode, the text describes the default action. If the default action is displayed as an icon only, all the menu items must contain icons.
Split type
Display types
The menu button supports three display types.
A: Text only
B: Icon only
C: Text and icon
Display types
Hierarchy types
Emphasized
The emphasized menu button appears with a blue background and white text and icons. Use it for primary actions.
Emphasized type
Standard
The standard menu button appears with a white background and subtle gray border. Use it for secondary actions.
Standard type
Transparent
The transparent menu button appears with a transparent background and no border. Use it for tertiary actions.
Transparent type
States
Component states
The menu button has two component states: enabled and disabled.
A: Enabled: Displays an interactive state and supports selection.
B: Disabled: Displays a non-interactive state.
Enabled (A) and disabled (B) states
For more information, see Component States.
Interaction states
The menu button has three interaction states: regular, hover, and down.
A. Regular: Displays the default interaction state.
B. Hover: Displays the hover state when the cursor is over an enabled menu button.
C. Down: Displays the pressed state during interaction.
Regular (A), hover (B), and down (C) states
For more information, see Interaction States.
Focus states
The focus state indicates which component is currently focused and provides visual feedback for users who rely on assistive technology or don’t use a mouse.
Focus state appears as an additional visible border that the menu button receives.
When interacting using a keyboard, the focus state appears on the entire split menu button. When interacting using a mouse, it appears only on the specific area the user clicks.
Focus states
For more information, see Focus States.
Value states
Menu buttons support value states to indicate status using distinct colors.
A. Negative: Indicates an error or issue that requires resolution.
B. Critical: Signals a warning or something that needs caution or a follow-up action.
C. Positive: Shows success or confirmation that an action has been completed.
Negative (A), critical (B), and positive (C) states
For more information, see Value States.
Behavior and Interaction
Mouse interaction
Regular menu button
The regular menu button has a single interactive area. Selecting it opens a menu that contains multiple available actions.
A: When clicking on the menu button without releasing the click, the down and focus states are applied.
B: After releasing the click, the menu opens, and the focus state is applied on the first item.
Regular menu button interaction
Split menu button
The split menu button consists of two interactive areas: the default action and the arrow icon. Selecting the default action triggers the default action directly, while selecting the arrow icon opens a dropdown menu with additional actions. A separator between the two interactive areas indicates that they trigger different behaviors. When a menu item is chosen, its action is triggered and the menu closes.
A: When clicking on the right interactive area without releasing the click, the down and focus states are applied. The left interactive area stays in regular state.
B: After releasing the click, the menu opens, and focus state applies on the first option.
Split menu button interaction
Touch interaction
On touch devices, the behavior is similar to the mouse interaction, without the hover and focus states.
For more information, see Gestures.
Tooltip
Always provide a tooltip when the menu button appears as icon-only.
Icon-only menu and split buttons with tooltip
Display an “Open Menu” tooltip on the arrow icon in split menu buttons.
A split button with a tooltip displayed on the arrow icon
For more information, see Using Tooltips.
Menu position
By default, the menu is horizontally left-aligned to the menu button. Alternatively, it can also be center-aligned or right-aligned.
By default, when sufficient space is available, the menu appears below the menu button.
Menu position: below the menu button
If space is limited, the menu opens above the menu button to ensure full visibility and to avoid overlapping or extending beyond the viewport.
Menu position: above the menu button
Default action :badge, info, large, _, SAPUI5 Only:
In a split menu button, the left interactive area’s default action can be either static or dynamic.
Static
After triggering the default action or an action from the menu, the default action of the left interactive area stays unchanged.
Static default action
Dynamic
After triggering an action from the menu, the triggered action becomes the new default action of the left interactive area.
Dynamic default action
Responsiveness
By default, the menu button fits the width of the text.
Menu and split buttons with different lengths
If the menu button has a fixed width, its text can truncate if it’s too long to fit.
Menu and split buttons with a fixed width and different text length
The menu button supports cozy and compact content densities.
Cozy content density (top) and compact content density (bottom)
For more information, see Content Density.
Accessibility
SAP follows international standards, such as WCAG and WAI-ARIA, and strives to make our business solutions accessible and inclusive.
For more information, see Accessibility in SAP Fiori and the Accessibility Design Tools Handbook.
Keyboard navigation
The following keyboard combinations are supported by the SAPUI5 menu button component.
Screen reader support
For additional details on screen reader support and Accessible Rich Internet Applications (ARIA), see UI5 Screen Reader Support and WAI-ARIA Authoring.
Content
Text
- Choose a button text that is short and meaningful. Check out the UI text guidelines for more information.
- Keep in mind that the text can be up to 300% longer in other languages.
Truncation
- Keep button labels within the button width to avoid truncation. If truncation is unavoidable due to design constraints, ensure the truncated text still conveys the intended action clearly.
- Adjust button or text size responsively to reduce truncation across screen sizes.
For more information, see Wrapping and Truncation.
Localization
The menu button supports left-to-right (LTR) and right-to-left (RTL) reading directions. All features work in both directions.
Menu button – left-to-right
Menu button – right-to-left
Framework Comparison
Some behaviors differ between frameworks due to implementation specifics. In SAP Web Components, the menu button is not a standalone component but a pattern built from a regular button (ui5-button) with a down-arrow icon, which indicates that it opens a menu (ui5-menu). The split button is available as a dedicated component (ui5-split-button) in SAP Web Components, while in SAPUI5, the split button behavior is provided as a type of the dedicated menu button component.
The table below summarizes the differences between SAPUI5 and SAP Web Components.
Related Links
Guidelines
Components
Button
Toggle Button
Segmented Button
Menu
Implementation
SAPUI5
Menu Button (samples)
Menu Button (API reference)
SAP Web Components
Menu Button
Split Button
Guidelines
Components
Button
Toggle Button
Segmented Button
Menu
Implementation
SAPUI5
Menu Button (samples)
Menu Button (API reference)
SAP Web Components
Menu Button
Split Button
UI Kit (Figma)
SAP Fiori for Web UI Kit / Menu Button