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

Menus: Guidelines ​

Menus display a list of choices on a temporary surface


A menu in the vibrant color style is more expressive, and one with standard colors is more utilitarian

Usage ​

Use a menu to show a temporary set of actions. To show actions on screen at all times, use a toolbarToolbars display frequently used actions relevant to the current page.More on toolbars instead.

A menu takes up less space than a set of radio buttonsRadio buttons let people select one option from a set of options.More on radio buttons or chipsChips help people enter information, make selections, filter content, or trigger actions.More on chips.

Color options

Menus have two color mappings:

  • Standard: Surface-based, lower visual emphasis
  • Vibrant: Tertiary-based, higher visual emphasis

Vibrant menus are more prominent, and should be used sparingly.

Menu shows item “Line spacing” opening a submenu. In the second menu, “Custom 1.2” is selected with vibrant color.
On web, menus can open submenus

Opening menus

Menus temporarily appear in front of all other permanent UI elements.

A menu should open when a person:

  • Selects an element, such as an icon, buttonButtons let people take action and make choices with one tap.More on buttons, or text field
  • Performs a specific action to trigger the menu, like right-click or press-and-hold

Use menus in situations that need extra actions, like:

  • Overflow menus
  • Text field dropdown menus
  • Select menus
  • Context menus
A grouped menu with Undo, Redo, Cut, Copy, and Paste options appear over highlighted text in an ebook.
Menus appear in front of all other UI elements

Menu groups

Vertical menu items can be grouped by adding a divider or small gap. Use groups to bundle similar actions together.

Gaps and dividers guidelines

2 vertical menus: a standard menu with no gap and a grouped menu with 1 gap.

Menu items can be grouped to be more scannable:

  1. Standard vertical menu
  2. Grouped vertical menu

Context menus ​

Context menus provide a list of additional actions a person can take on an item. A secondary click, like a right-click on a mouse or a two-finger tap on a trackpad, opens a context menu.

A context menu pops up from a newspaper link. The menu items are: Open in new window, Save link as, Copy address, and Inspect.
A context menu appears when right clicking with a mouse or trackpad. It can reveal key actions related to the associated content.

Anatomy ​

Diagram outlining 11 elements of a menu’s anatomy.
  1. Menu item
  2. Leading icon (optional)
  3. Menu item text
  4. Trailing icon (optional)
  5. Badge (optional)
  6. Trailing text (optional)
  7. Container
  8. Supporting text (optional)
  9. Label text (optional)
  10. Gap (optional)
  11. Divider (optional)

Menu items ​

Menu items can include label text, leading icons, trailing icons, and keyboard commands.

When a menu item can only be used under specific conditions, it should appear disabledA disabled state communicates a non-interactive component or element.More on disabled state rather than be removed.

Menu shows 1 item that’s  disabled, “Redo”. The text color of the disabled item is lighter than the active items.
The Redo action is disabled when that action isn’t available

Gaps & dividers (optional)

Gaps and dividers can be used to separate and group menu items.

Gaps

Use a gap to visually divide menu items into distinct groups. Gaps are more expressive than dividers and make the relationship between items clear.

  • Avoid changing the size of the gap
  • Limit the number of gaps in a menu to one or two
  • Don’t use gaps in scrollable menus
2 vertical menus with 5 items. A gap separates items into a group of 3 and group of 2.
Gaps separate menu items using expressive shapes

TIP

Gaps are not currently available on web

Dividers

Dividers create a more subtle separation between items. Use a divider for:

  • Scrollable menus
  • Text fields with a dropdown menu, where a grouped treatment isn’t appropriate

On web, use a divider to separate menu items.

A menu on a web interface with items separated by a divider line.
Dividers separate menu items in baseline menus and on web

Flexibility & slots ​

Menus have custom slots that support more flexible item layouts.

When creating a complicated menu, think of the menu item as a container with a swappable slot.

Slots work best with simple content such as:

  • Images
  • Progress indicators
  • Color swatches
A menu showing an undefined slot that could be used for a different element, such as an image.
Slots can appear anywhere in a menu

Slot accessibility

Use caution when adding slots to menus:

  • Make sure the menu remains accessible
  • Elements must follow the rules and interaction patterns of the menu component
  • Keep the same menu item padding
  • Targets should be 48x48dp or larger

Don't add buttons, switches, or other direct actions into the menu item. Nested elements should only perform one action. Adding multiple actions can break keyboard navigation and screen reader functionality.

More on required accessibility guidelines

1 diagram and 1 menu showing icons in each item’s leading slot.
Caution Reserve the use of slots for use cases that maintain the menu’s accessibility and functionality

Placement ​

A menu is positioned relative to the window edge. It typically appears below, next to, or in front of the element that generates it.

If a menu is in a position to be cut off, it should automatically reposition to appear to the left, right, or above the element that generates it.

6 abstract shapes showing how a menu can extend from the edge of the screen.
Menus can appear around or in front of the element that opened them

Submenus

Submenus should open next to the parent menu item without overlapping it.

Submenus are best used on large screens where there's space. See adaptive guidance for alternatives on mobile.

A submenu opens to the right of its parent menu item, and doesn’t cover it. A selected submenu item includes a checkmark and vibrant highlight.
Position submenus to the side of the parent item

TIP

Submenus are not currently available on Jetpack Compose

Adaptive design ​

Compact breakpoints

Consider adapting menus into bottom sheetsBottom sheets show secondary content anchored to the bottom of the screen.More on bottom sheets on small screens. They have more space to display additional items and longer labels.

A bottom sheet shows longer labels and improved readability on a compact window.
A bottom sheet can replace a menu on smaller screens

Other breakpoints

On mediumWindow widths from 600dp to 839dp, such as a tablet or foldable in portrait orientation.More on medium breakpoints and expandedWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints windows, menus are most effective as they appear in context with the content. On larger screens, menus can also display more items, and can use submenus to organize complex sets of options.

A menu with vibrant color on a mid-size screen, with the same elements as a bottom sheet.
On large screens, a menu is often more appropriate than a bottom sheet

Behavior ​

Appearing

A menu can appear when a person interacts with an element on the page, like a button, text field, filter chip, or highlighted text.

A menu’s position on screen affects where and how it appears. If opened at the top of the screen, it expands downwards to avoid being cropped.

Menus at different positions on a screen open in different directions, adapting to the available space
A menu can open from a split button
A menu can appear in context, like next to highlighted text or a selected image
A menu can open from a text field
A menu can open from a filter chip

Motion

Menus use an enter and exit transition. This animation creates a relationship between the menu and the element that generates it.

When a menu expands, the trigger element becomes pressed. When an item is selected, a ripple appears on touch.

A menu expands when opened, and has a ripple when an item is selected

In dense products, such as on desktop, menus can open instantly to reduce motion.

Desktop menus can open instantly

Filtering

A menu can include a text field to filter options. This pattern is also known as autocomplete.

As someone types, the list of menu options filters to show relevant results. This helps people quickly find the right option from a long list.

Menu items ease into their new position as the menu is filtered.

As a person types in the text field, the menu options filter to match the input

Scrolling

Menus can scroll when all menu items can’t display at once. In this state, menus show a persistent scrollbar.

Don’t use gaps if a menu scrolls; this is currently unsupported.

When content is scrollable, menus display scrollbars

Selecting

When a menu is opened, the corresponding buttonButtons let people take action and make choices with one tap.More on buttons or icon buttonIcon buttons help people take minor actions with one tap.More on icon buttons should remain the same visually, with the addition of a pressed state.

This should happen even when opening from a keyboard shortcut.

The overflow icon remains the same, even after the menu is opened.
Tapping the icon triggers a menu. Choosing a menu option doesn’t change the icon generating the menu.

Single- and multi-select menus

Menus can allow either single-select or multi-select actions:

  • Single-select menus can have one item selected at a time. When a new item is selected, the previously selected item is automatically unselected.
  • Multi-select menus can have many selected items. They stay open until the person dismisses the menu.

More on selection accessibility requirements

1 menu for dietary options shows a single selection, Vegan. Another menu shows Vegan and Nut-free selections at the same time.
Menus can be single- or multi-select

Focus ​

When a menu has multiple submenus, focus follows the current hovered or focused submenu.

Shape morphing

As a person moves from one submenu to the next, the corners of the focused submenu become more rounded, while the unfocused submenu becomes less rounded. This adds a dynamic quality to menu interactions.

On a custom menu, the corner shape changes to indicate focus as the cursor moves across submenus

Density ​

On web only, density levels control the spacing between elements. Increasing density decreases the top and bottom padding. More on layout density

4 menus becoming increasingly dense and compressed.
Density of menus from 0 to -3
Pager
Previous pageMenus: Specs
Next pageMenus: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/menus/guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google