Bottom sheet

v3.1

The bottom sheet is a native-only component that presents supplemental content anchored to the bottom of the screen.

For web, use a Dialog instead.

  • CSS
  • Marko
  • React
Stylized artwork of a bottom sheet.

Anatomy

Properties

Behavior

Height

The height of the sheet can be smaller than 50% of the screen height if there are only a few options. The minimum height is 30% of the screen height. It’s acceptable to have white space below options if the minimum height has additional room below the sheet content.

Content should open directly to a full modal overlay for long-form content or a large selection group with no apparent hierarchy of importance.

A bottom sheet containing a category selector is taking up 30% of the mobile screen height.

30% minimum height

A bottom sheet containing a category selector is taking up 30% of the mobile screen height.

Full modal

Device keyboards

If a sheet has input fields, the sheet expands upward with the native keyboard as the field gains focus. The sheet moves back down when the keyboard is collapsed.

A bottom sheet showcases the iOS number keyboard.

iOS keyboard

A bottom sheet showcases the Android number keyboard.

Android keyboard

Modality

Bottom sheets can be either modal or non-modal. The default is modal, so interactions with the main page are blocked by a scrim until the sheet is dismissed.

Non-modal sheets omit the scrim and allow for interactions with the main page and the sheet content. This is common for experiences like navigating a map. A non-modal sheet allows for freedom of movement of the content below while also providing quick access to supplemental information.

A modal bottom sheet is shown with single select for selecting a category.

Modal bottom sheet

A non-modal bottom sheet is shown with an interactive map element.

Non-modal bottom sheet

Screen size

Small screens

Sheets extend the full width of the screen and can open partially or fully by default. Partial height sheets expand to full height sheets when the content is scrollable.

Use bottom sheets for focused breakout tasks and selecting from a large list.

A bottom sheet spanning 50% of the page height on iOS.

iOS modal stack

A bottom sheet spanning 100% of the page height on iOS, with a popover menu below an overflow icon.

Android fullscreen overlay

Best practices

Specs

A bottom sheet with specs is shown. The top padding of the container is 8px, the left and right padding of the container is 16px. There is a 32px close action and the title is middle-aligned with the button.