Updated: February 11, 2023

Toolbar

UIToolbar

Intro

The toolbar is a component with one or more buttons that is always located at the bottom edge of the screen. It is used for closing or finalizing actions that impact the current view. When scrolling, the toolbar remains fixed and does not scroll away.

Toolbar in compact (left) and regular width (right)
Toolbar in compact (left) and regular width (right)

Usage

Information
Western readers usually scan a view in a Z-pattern – from left to right and top to bottom. As a result, the best position for a finalizing action is the bottom right side of a view.
Do
  • Use the toolbar if you need closing or finalizing actions.
  • Use concrete and concise verbs as button labels.
  • Use an overflow menu if your toolbar on iPhone needs more than two text buttons.
  • Use an overflow menu if your toolbar on iPad needs more than three text buttons.
  • If your toolbar contains three or fewer buttons, consider using concise text labels instead of icon buttons to add clarity.
  • If your toolbar contains more than three buttons, consider using icon buttons or the overflow menu to conserve space. Keep in mind to only use icon buttons for actions if they can be represented by universally recognized icons.
Don't
  • Don’t use the toolbar if the action from the toolbar influences only specific items.
  • Don’t mix icon and text buttons within a toolbar. Before mixing, we recommend changing every icon button to a text button. The only icon button that can be mixed with text buttons is the overflow button.
  • Don’t mix tertiary buttons with secondary or primary buttons within a toolbar.
  • Don’t use the helper text if your toolbar has an overflow button.

Anatomy

A. Toolbar Container

The toolbar container contains one or more buttons. The toolbar is always visible, even when users scroll down.

B. Secondary Text Button

Actions that are not the primary action should be formatted as secondary buttons. If the view has no clear primary action or if the displayed actions have the same relevance, the toolbar can consist of only secondary buttons. Use the secondary style only if there are two or more buttons within the toolbar.

C. Primary Text Button

Emphasize the most important action with the primary button style. Show only one primary action for the entire view. If the toolbar has only one button, we recommend formatting the button in primary style.

D. Overflow Button

If the toolbar has more than two text buttons in compact view, the additional text buttons move into an overflow menu. The most important actions are displayed first. In regular view, the overflow appears after three text buttons.

E. Tertiary Text Button

Tertiary text buttons can be used if the toolbar consists of additional actions that the user may need to access. Tertiary text buttons can be used if the toolbar should be subtle, yet perceivable.

F. Helper Text

The helper text can be used for displaying information or status. It is read-only and not tappable.

G. Tertiary Icon Button

Tertiary icon buttons can be used if the toolbar consists of additional actions that the user may need to access. Tertiary icon buttons can be used if the toolbar should be subtle, yet perceivable. Keep in mind to use icon buttons that can be represented by universally recognized icons.

Toolbar anatomy with variants
Toolbar anatomy with variants
Information
We recommend using filled buttons, such as primary or secondary buttons, for the most likely actions in a view. Filled buttons have a container with a solid fill. 
The filled style is visually more prominent than tertiary buttons which helps people quickly identify the action they want to perform.

Semantic Actions

We recommend formatting semantic buttons in secondary button style. For negative or destructive actions, the negative red button can be used. For positive actions, use the secondary style in tint color. The positive action should be placed on the right side (as can be seen in the image).

Semantic actions within a toolbar
Semantic actions within a toolbar

Behavior and Interaction

Overflow Menu

Amount of Text Buttons

A maximum of two text buttons can be displayed in the toolbar in compact view. If the toolbar has more than two text buttons, the additional text buttons move into an overflow menu. The most important actions are displayed first. In regular view, the overflow appears after three text buttons.

Overflow Interaction

Tapping on the overflow button opens an action sheet with additional action buttons (see image below).

Tapping on the overflow button (left) opens an action sheet with additional actions (right)
Tapping on the overflow button (left) opens an action sheet with additional actions (right)

Long Button Labels

The overflow should always be activated when there is not enough space to display all the buttons. If there is for example not enough space to display two buttons because the button text is too long the secondary button moves into the overflow and the more important action is stretched over the full width of the toolbar (see image below).

An overflow button should also be used when both buttons do not fit into the toolbar’s width
An overflow button should also be used when both buttons do not fit into the toolbar’s width
Information
Truncated labels in buttons do not meet our accessibility standards since it is not possible to retrieve the full label text. App teams should implement an overflow behavior to ensure that all actions can be accessed at any time. The buttons are sorted by usage, with the most frequently used action first (on the right). This ensures that the most important buttons are the last to be moved into the overflow menu.

Adaptive Design

The toolbar spacing follows the global layout margins of the iOS and iPadOS size classes. It uses 100% of the screen width.

In compact view, the buttons are equally distributed across the container of the toolbar. In regular view, the buttons are aligned to the right side of the container to provide convenient access to the buttons.

The toolbar hides once a keyboard is on screen.

Toolbar in compact (left) and regular width (right)
Toolbar in compact (left) and regular width (right)

Variations

The toolbar can be flexibly adapted depending on the context, amount and importance of the actions. App designers must decide here which toolbar variant makes the most sense for their app. If the current view has a clear primary action, then a toolbar with primary action might be a good choice. If there is no clear primary action, then a toolbar with only secondary or only tertiary buttons should be considered.

Toolbar variations
Toolbar variations

Resources

SAP Fiori for Android: Footer

SAP Fiori for Web: Footer Toolbar

Human Interface Guidelines: Toolbars