Usage
Bottom sheets on Android provide secondary actions or contextual content that complement the main screen content. They slide up from the bottom edge of the screen and can contain actions, lists, or form-based interactions.
Design properties
| Property | Values | Default |
|---|---|---|
| Scrim Variant | False | True | False |
| Supporting text Text | string | Bottom sheets show secondary content anchored to the bottom of the screen. |
| Title text Text | string | Sheet title |
| Show supporting text Boolean | true | false | false |
| Show header area Boolean | true | false | true |
Types
Fixed list
Present a consistent set of actions or destinations.
Dynamic list
Displays lists and/or content that adapt to context or user state.
Input and form
Collect user decisions or inputs usually requiring user action.
Behavior and interaction
- Bottom sheets slide upward from the screen and can be dismissed via either swiping down, tapping outside, or completing a required action.
- The height of the bottom sheet can take up half the screen or sometimes expand full-height.
- Always display a scrim behind the bottom sheet when it’s open. The scrim reduces visual competition from background content and reinforces focus on the sheet.
- The underlying content remains visible behind the scrim, emphasizing the bottom sheet’s role as secondary and contextual rather than primary UI.
Related components
Changelog
|
Date |
Version |
Notes |
|---|---|---|
|
November 24, 2025 |
1.0.0 |
First release of Bottom sheet component documentation |