Skip to content

Elevation ​

Elevation is the distance between two surfaces on the z-axis

Overview · Applying elevation · Tokens

Tokens ​

Elevation levels can be implemented with tokens. Surface tint color is deprecated. Use elevation level tokens (0–5) instead. Learn more about design tokens

Design tokens

Token table

Machine-readable relationship table

Elevation tokens · 1 token set · 7 tokens · live token table · DSDB ELEVATION.20543ce18892f7d9

  • Default context: Theme: Light · Platform: Android · Audience: 3P · Contrast: Default · iOS dark theme elevation: None · iOS weight setting: Default
  • Not configurable here (group default used): Motion scheme: Standard · Font: Static · Language height: Small
  • Other contexts: Theme: Dark · Contrast: Medium contrast, High contrast. "Other contexts" lists values that differ from the default when only that one context changes.
  • Reference chain: aliases from the token to its source value (token → alias → … → value). "—" means the token holds a literal value.

Elevation · md.sys.elevation · 7 tokens

Elevation level tokens

GroupTokenTypeReference chainResolved valueOther contexts
All tokensmd.sys.elevation.surface-tint-color (deprecated)Colormd.sys.color.primary → md.ref.palette.primary40#6750A4Dark: #D0BCFF via md.ref.palette.primary80
Medium contrast: #4F378B via md.ref.palette.primary30
High contrast: #381E72 via md.ref.palette.primary20
All tokensmd.sys.elevation.level5Elevation—12dp—
All tokensmd.sys.elevation.level4Elevation—8dp—
All tokensmd.sys.elevation.level3Elevation—6dp—
All tokensmd.sys.elevation.level2Elevation—3dp—
All tokensmd.sys.elevation.level1Elevation—1dp—
All tokensmd.sys.elevation.level0Elevation—0dp—

Component elevation ​

Most components have a default elevation. Component elevation is only used to determine where the component sits in relation to other components, including when hovered or focused (which usually raises elevation by one level). Elevation has no shadow or value of its own by default.

Resting levelComponentDP Height
5(not assigned as resting level)12dp
4(not assigned as resting level)8dp
3Date pickers
Dialogs (modal)
Extended FAB
FAB
FAB menu (close button)
Search
Time pickers
6dp
2App bar (scrolled)
Menu
Navigation bar
Rich tooltip
Toolbar
3dp
1Banner
Bottom sheet (modal)
Button (elevated)
Card (elevated)
Chips (elevated)
Navigation drawer (modal)
Side sheet (modal)
1dp
0App bar (not scrolled)
Buttons (filled, tonal, outlined)
Button groups
Cards (filled, outlined)
Carousel
Chips
Dialog (full-screen)
Extended FAB (in navigation rail)
FAB (in navigation rail)
FAB menu (list items)
Icon buttons
List
Navigation rail
Segmented button
Side sheet (docked)
Slider
Split button
Tabs
0dp

Unofficial offline mirror. Content © Google, licensed under CC BY 4.0.