Skip to content
Material Design 3
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Foundations

Accessibility

Overview: Principles

Overview: Assistive technology

Designing: Overview

Designing: Color contrast

Designing: Structure

Designing: Flow

Designing: Elements

Writing and text: Best practices

Writing and text: Text truncation

Writing and text: Text resizing

Building for all: User needs

Building for all: Co-design

Content design

Overview

Alt text

Global writing: Overview

Global writing: Word choice

Notifications

Style guide: UX writing best practices

Style guide: Word choice

Style guide: Grammar and punctuation

Customizing Material

Devices

Watches: Overview

Watches: Foundations

Watches: Styles

Watches: Layout

XR

Design: Overview

Design: Interaction

Design: Layout

Design: Accessibility

Components: Overview

Components: App bars

Components: Dialogs

Components: Nav bar

Components: Nav rail

Components: Toolbars

Design tokens: Overview

Design tokens: How to use tokens

Interaction

Gestures

Inputs

Selection

States: Overview

States: State layers

States: Applying states

Layout

Overview: Overview

Overview: Parts of layout

Overview: Adaptive design

Scaffold: Overview

Scaffold: Bars

Scaffold: Rails

Scaffold: Panes

Grids & spacing: Overview

Grids & spacing: Grids

Grids & spacing: Spacing

Grids & spacing: Density

Breakpoints: Overview

Breakpoints: Compact

Breakpoints: Medium

Breakpoints: Expanded

Breakpoints: Large & extra-large

Bidirectionality & RTL

Canonical examples: Overview

Canonical examples: Feed

Canonical examples: List-detail

Canonical examples: Supporting pane

Usability: Overview

Usability: Applying M3 Expressive

Material A-Z

Styles

Color

Color system: Overview

Color system: How the system works

Color roles

Color schemes

Choosing a scheme

Static: Baseline

Static: Custom brand

Dynamic: Choosing a source

Dynamic: User-generated source

Dynamic: Content-based source

Advanced: Overview

Advanced: Apply colors

Advanced: Define new colors

Advanced: Adjust existing colors

Color resources

Elevation: Overview

Elevation: Applying elevation

Elevation: Tokens

Icons: Overview

Icons: Designing icons

Icons: Applying icons

Motion

Motion physics system: How it works

Motion physics system: Specs

Easing and duration: Applying easing and duration

Easing and duration: Tokens & specs

Transitions: Transition patterns

Transitions: Applying transitions

Shape: Overview & principles

Shape: Corner radius scale

Shape: Shape morph

Spacing: Overview

Spacing: Applying spacing

Spacing: Tokens

Typography: Overview

Typography: Fonts

Typography: Type scale & tokens

Typography: Applying type

Typography: Editorial treatments

Components

App bars: Overview

App bars: Specs

App bars: Guidelines

App bars: Accessibility

Badges: Overview

Badges: Specs

Badges: Guidelines

Badges: Accessibility

Buttons

All buttons

Button groups: Overview

Button groups: Specs

Button groups: Guidelines

Button groups: Accessibility

Buttons: Overview

Buttons: Specs

Buttons: Guidelines

Buttons: Accessibility

Extended FABs: Overview

Extended FABs: Specs

Extended FABs: Guidelines

Extended FABs: Accessibility

FAB menu: Overview

FAB menu: Specs

FAB menu: Guidelines

FAB menu: Accessibility

FABs: Overview

FABs: Specs

FABs: Guidelines

FABs: Accessibility

Icon buttons: Overview

Icon buttons: Specs

Icon buttons: Guidelines

Icon buttons: Accessibility

Segmented buttons: Overview

Segmented buttons: Specs

Segmented buttons: Guidelines

Segmented buttons: Accessibility

Split button: Overview

Split button: Specs

Split button: Guidelines

Split button: Accessibility

Cards: Overview

Cards: Specs

Cards: Guidelines

Cards: Accessibility

Carousel: Overview

Carousel: Specs

Carousel: Guidelines

Carousel: Accessibility

Checkbox: Overview

Checkbox: Specs

Checkbox: Guidelines

Checkbox: Accessibility

Chips: Overview

Chips: Specs

Chips: Guidelines

Chips: Accessibility

Date & time pickers

Date pickers: Overview

Date pickers: Specs

Date pickers: Guidelines

Date pickers: Accessibility

Time pickers: Overview

Time pickers: Specs

Time pickers: Guidelines

Time pickers: Accessibility

Dialogs: Overview

Dialogs: Specs

Dialogs: Guidelines

Dialogs: Accessibility

Divider: Overview

Divider: Specs

Divider: Guidelines

Divider: Accessibility

Lists: Overview

Lists: Specs

Lists: Guidelines

Lists: Accessibility

Loading & progress

Loading indicator: Overview

Loading indicator: Specs

Loading indicator: Guidelines

Loading indicator: Accessibility

Progress indicators: Overview

Progress indicators: Specs

Progress indicators: Guidelines

Progress indicators: Accessibility

Menus: Overview

Menus: Specs

Menus: Guidelines

Menus: Accessibility

Navigation

Navigation bar: Overview

Navigation bar: Specs

Navigation bar: Guidelines

Navigation bar: Accessibility

Navigation drawer: Overview

Navigation drawer: Specs

Navigation drawer: Guidelines

Navigation drawer: Accessibility

Navigation rail: Overview

Navigation rail: Specs

Navigation rail: Guidelines

Navigation rail: Accessibility

Radio button: Overview

Radio button: Specs

Radio button: Guidelines

Radio button: Accessibility

Search: Overview

Search: Specs

Search: Guidelines

Search: Accessibility

Sheets

Bottom sheets: Overview

Bottom sheets: Specs

Bottom sheets: Guidelines

Bottom sheets: Accessibility

Side sheets: Overview

Side sheets: Specs

Side sheets: Guidelines

Side sheets: Accessibility

Sliders: Overview

Sliders: Specs

Sliders: Guidelines

Sliders: Accessibility

Snackbar: Overview

Snackbar: Specs

Snackbar: Guidelines

Snackbar: Accessibility

Switch: Overview

Switch: Specs

Switch: Guidelines

Switch: Accessibility

Tabs: Overview

Tabs: Specs

Tabs: Guidelines

Tabs: Accessibility

Text fields: Overview

Text fields: Specs

Text fields: Guidelines

Text fields: Accessibility

Toolbars: Overview

Toolbars: Specs

Toolbars: Guidelines

Toolbars: Accessibility

Tooltips: Overview

Tooltips: Specs

Tooltips: Guidelines

Tooltips: Accessibility

On this page

Bottom sheets: Guidelines ​

Bottom sheets show secondary content anchored to the bottom of the screen


Two variants of bottom sheets.
  1. Standard bottom sheets
  2. Modal bottom sheets

Usage ​

Bottom sheets display supplementary content and actions on a mobile screen.

Photo sharing bottom sheet with contact list, app icons, and action buttons.
Bottom sheet containing contacts and applications

Bottom sheets are a versatile component that can contain a wide variety of information and layoutsLayout is the visual arrangement of elements on the screen.More on layout, including menuMenus display a list of choices on a temporary surface.More on menus items (in listLists are continuous, vertical indexes of text and images.More on lists or grid layouts), actions, and supplemental content.

Bottom sheet displaying 3 menu options.
Bottom sheet with menu items in a list

Anatomy ​

A container is the only required element of a bottom sheet. Bottom sheet layoutsLayout is the visual arrangement of elements on the screen.More on layout can vary widely to support the kinds of content they contain.

3 elements of a bottom sheet.
  1. Container
  2. Drag handle (optional)
  3. Scrim (modal only)

Container ​

Bottom sheet containers hold all bottom sheet elements. Their size is determined by the space those elements occupy.

The container is the only required element of a bottom sheet. All other elements are optional.

Empty bottom sheet container.
Bottom sheets are flexible containers that adapt to their content and available space

List items (optional) ​

ListsLists are continuous, vertical indexes of text and images.More on lists are a continuous group of text or images. List items can include label text, icons, and text buttonsButtons let people take action and make choices with one tap.More on buttons, among other elements.

A bottom sheet displaying a list of actions for a song.
Bottom sheet containing a list with icons

Dividers (optional) ​

DividersDividers are thin lines that group content in lists or other containers.More on dividers can be used to separate related content in bottom sheets.

Bottom sheet with image action buttons and contact list separated by an inset divider.
Bottom sheet with a divider separating kinds of actions

Media (optional) ​

Thumbnail
Bottom sheets can include thumbnails for an avatar or logo.

Image
Bottom sheets can include photos, illustrations, and other graphics, such as weather icons.

Video
Bottom sheets can include video.

A bottom sheet displaying various media formats, including thumbnails, images, and video.
Bottom sheets can contain thumbnails, images, and video

Standard bottom sheets ​

Standard bottom sheets co-exist with the screen’s main UI region and allow for simultaneously viewing and interacting with both regions, especially when the main UI region is frequently scrolled or panned.

Use a standard bottom sheet to display content that complements the screen’s primary content, such as an audio player in a music app.

Bottom sheet with music player controls visible while browsing albums.
The music player in this standard bottom sheet allows people to control their music while browsing albums

At full-screen height, standard bottom sheets contain a collapse icon in an app bar to return to their initial position.

Standard bottom sheets can contain supplementary content that continues below the screen, such as location information over a map.

A bottom sheet can have preset positions from full-screen height to preview

Modal bottom sheets ​

Like dialogsDialogs provide important prompts in a user flow.More on dialogs, modal bottom sheets appear in front of app content, disabling all other app functionality when they appear, and remaining on screen until confirmed, dismissed, or a required action has been taken.

A modal sheet with filter options to categorize files in the app.
A modal bottom sheet must be interacted with or dismissed. Its blocking behavior makes it suitable for a menu, such as in this files app, to help people focus on their available choices.

Use a modal bottom sheet as an alternative to inline menusMenus display a list of choices on a temporary surface.More on menus or simple dialogsDialogs provide important prompts in a user flow.More on dialogs on mobile, especially when offering a long listLists are continuous, vertical indexes of text and images.More on lists of action items, or when items require longer descriptions and icons.

Modal bottom sheets are used in mobile apps only.

A modal bottom sheet displayed as an alternative to a traditional menu, presenting a list of actions.
Modal bottom sheets can be used instead of menus to present additional actions

Visibility ​

To provide access to its top actions, the initial vertical position of modal bottom sheetsModal bottom sheets appear in front of app content, disabling all other app functionality when they appear, and remaining on screen until confirmed, dismissed, or a required action has been taken. is capped at 50% of the screen height.

Modal bottom sheets whose contents exceed 50% of the screen height can then be pulled across the full screen and scrolled internally to access their remaining items.

A modal bottom sheet covering half of the screen, so both images and actions are accessible.
The initial vertical position of modal bottom sheets can't exceed 50% of the screen height

Modal bottom sheetsModal bottom sheets appear in front of app content, disabling all other app functionality when they appear, and remaining on screen until confirmed, dismissed, or a required action has been taken. appear when triggered by a user action, such as tapping a buttonButtons let people take action and make choices with one tap.More on buttons or an overflow icon. They can be dismissed by:

  • Tapping a menuMenus display a list of choices on a temporary surface.More on menus item or action within the bottom sheet
  • Tapping the scrim
  • Swiping the sheet down
  • Using a close affordance within the bottom sheet’s app barApp bars display information and actions at the top of a screen.More on app bars, if available

Display a close affordance in a full-screen modal bottom sheet.

A modal bottom sheet disappearing by tapping the scrim.
Tapping the scrim dismisses a modal bottom sheet
A modal bottom sheet disappearing by swiping the sheet down.
A modal bottom sheet can be dismissed by swiping the sheet down

Responsive layout ​

Compact breakpoint

In compact breakpointsWindow widths smaller than 600dp, such as a phone in portrait orientation.More on compact breakpoints, like mobile devices, bottom sheets extend across the width of a screen and are elevated above the primary content.

A bottom sheet extended to the width of a mobile screen.
Bottom sheets should extend to the width of the screen on mobile

Medium and expanded breakpoints

For larger screens with mediumWindow widths from 600dp to 839dp, such as a tablet or foldable in portrait orientation.More on medium breakpoints and expanded breakpointsWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints, bottom sheets have a default max-width to prevent undesired layoutsLayout is the visual arrangement of elements on the screen.More on layout and awkward spacing. However, this can be overridden if needed. For more complex tasks and flows, consider using a non-transient surface such as a floating sheetFloating sheets show secondary content on a surface that can be anchored to the screen or moved..

A bottom sheet extended to its max-width on a large screen device, not spanning the full screen.
Bottom sheets on larger screens like tablet have a max width that can be overridden

On larger expanded breakpointsWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints, like desktop, a bottom sheet can be swapped for a side sheetSide sheets show secondary content anchored to the side of the screen.More on side sheets that shows similar content.

A side sheet on desktop.
Side sheets can contain the same content as bottom sheets and may be more suitable for desktop

Behavior ​

Bottom sheets can offer an expansion option where the sheet is fully raised and toggled between a collapsed and expanded stateStates show the interaction status of a component or UI element.More on states. This provides a more predictable footprint of the sheet, and can be set by the system or toggled by the user.

Bottom sheet fully raised, showing photo actions, sharing options, and albums to add the photo to.
A bottom sheet for sharing can appear fully raised if needed
Collapsed bottom sheet, showing focused set of options.
Alternately, a bottom sheet for sharing can appear collapsed for a more focused set of actions

Custom positioning ​

The drag handle can be dragged or selected to change the bottom sheet height.

Sheets should be able to cycle through preset heights and close completely without dragging. Selecting the drag handle should toggle through preset heights or close the sheet, while selecting the scrim should always close the bottom sheet.

If the bottom sheet has multiple preset heights but can’t use a drag handle, Material requires the inclusion of a single-pointer alternative to change height.

Bottom sheet with a visible drag handle that can be used to adjust its height.
Interacting with the drag handle can quickly move a bottom sheet through preset heights
Bottom sheet resized using the visible drag handle.
A bottom sheet can automatically resize to another height after interacting with the drag handle

Scrolling ​

Bottom sheets can be horizontally scrolled, independent of the rest of the screen’s content.

Bottom sheet that can be scrolled horizontally.
Bottom sheets should be scrollable when their content exceeds the initial viewable height

Back ​

On Android, a gestureGestures are all the ways people interact with UI elements using touch.More on gestures called predictive back allows a user to swipe left or right on the bottom sheet.

  • Bottom sheet detaches from the left and right edges of the screen to signal it will close
  • Previous screen is revealed in a preview

A list of compatible components is available in the gestures article.

Preview of the result of the gesture, release to commit, fling to commit, and cancel
Pager
Previous pageBottom sheets: Specs
Next pageBottom sheets: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/bottom-sheets/guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google