Bottom sheet

Also known as: Slide-up panel, Bottom drawer

Resources

Properties

PropertyValuesDefault
Has drag handle Booleantrue | falsetrue
Has title Booleantrue | falsetrue
Title TextstringTitle
Has action Booleantrue | falsetrue
Swap content InstanceSwapAny componentPlaceholder

Best practises

  • Bottom sheets are for use on mobile and tablet.
  • Use bottom sheets for secondary actions, that don’t require full screen attention.
  • Use them to present additional options or details without navigating away from the main screen.
  • Avoid stacking multiple bottom sheets.
  • Make sure bottom sheets are dismissable through close button or drag handle.

When to use

When providing supplementary or contextual content without navigation away from the main screen.

If the content is too complex, requires multiple steps or involves scrolling, consider full page view instead.
If the bottom sheet would unexpectedly interrupt user's workflow, use alert or snackbar instead.

Note:

Instance swap allows using custom content in a component. Read about the feature from Figma learn.

Behaviour

Bottom sheets typically slide in from the bottom of the screen and are most commonly used on mobile devices. Bottom sheets are always modal, meaning that the bottom sheet blocks user interaction with the rest of the interface until closed.

Size

Bottom sheets typically extend across the entire screen width in mobile devices for visual stability with the rest of the content. Height of the bottom sheet adapts fluidly with the device size and content.

SizeContext
Compact (20-30%)Quick actions, short summaries and previews.
Half height (~50%)Select menus, action confirmations with multiple options, short forms and lists.
Full height (90-100%)Complex forms and filters, onboarding, content editing and heavy data.