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

Icon buttons: Guidelines ​

Icon buttons help people take actions with a single tap


Icon buttons can be a wide variety of sizes, shapes, and colors. When placed in a button group, adjacent icon buttons respond to one another when pressed.

Usage ​

Use icon buttons to display common actions. There are two variants: default and toggle.

  • Default icon buttons can open other elements, such as a menuMenus display a list of choices on a temporary surface.More on menus or searchSearch lets people enter a keyword or phrase to get relevant information.More on search.
  • Toggle icon buttons can represent binary actions that can be toggled on and off, such as favorite or bookmark.

Icon buttons can be placed directly on the background or in most container components, such as cardsCards display content and actions about a single subject.More on cards, app barsApp bars contain page navigation and information at the top of a screenMore on app bars, and toolbarsToolbars display frequently used actions relevant to the current page.More on toolbars.

Multiple icon buttons can be placed in a standard button groupStandard button groups add interactions between adjacent buttons when they're pressed. to add interaction and motion between the buttons when pressed. More about standard button groups

Icon buttons in a toolbar.
Icon buttons can be used within other components, such as in a toolbar or card

Color

There are four icon button color styles, in order of emphasis:

  1. Filled
  2. Tonal
  3. Outlined
  4. Standard

For the highest emphasis, use the filled style. For the lowest emphasis, use standard.

Diagram of default and toggle icon buttons in 4 color styles.
The default (left) and toggle (right) icon buttons are available in all four color styles

Use a filled, tonal, or outlined icon button when the button needs more visual separation from the background.

Choose the right style and emphasis for the situation.

‘Heart” icon on a background about a cooking show.
Do Use icons with a background to make them easy to see on any surface
Text button and icon button in an app together.
Do When mixing button variants, use color styles to make the primary action clear

Use the filled style for visual impact and key actions that require high emphasis.

Avoid overusing the filled style on a screen. Use them sparingly.

Use filled icon buttons for high emphasis actions, such as downloading or deleting

Use the tonal style as a middle ground between filled and outlined icon buttons. It’s useful for secondary actions paired with a high emphasis action.

For example, use the tonal style for actions like Raise hand in a video meeting. When selected, its visual emphasis is greater than the outlined menu button, but less than the filled End call button.

Icons found on the bottom of a telephone screen, including a “hang up” icon with a bright red tone.
Leverage the different color styles to establish emphasis and direct people to important actions

Use the outlined style for medium-emphasis buttons. It’s useful when the button isn’t the main focus of the interaction, such as browsing through sets of cards.

Use the standard style for low-emphasis buttons, or when placing buttons on a colorful surface.

Left and right arrow outlined icon buttons indicating that more cards are available to browse.
Outlined buttons indicate that more content is available without grabbing attention

Size & width

Icon buttons are available in five different sizes:

  • Extra small - 32dp
  • Small - 40dp (default)
  • Medium - 56dp
  • Large - 96dp
  • Extra large - 136dp

And three widths:

  • Default
  • Narrow
  • Wide

Use size and width to provide emphasis and visual hierarchy in a page with multiple buttons. The main action should be the most visually prominent, whether through color or size, like starting and stopping a timer or playing and pausing a song.

Variety of buttons in a timer app.
Use different button colors and sizes to provide visual hierarchy and emphasize primary actions

Not all icon buttons will need to emphasize a primary and secondary action.

When buttons have a similar importance, they should be the same size.

Uniform button sizes in a calculator app.
When everything should have the same emphasis, use icon buttons that are the same size

Anatomy ​

Diagram of anatomy of outlined, standard, and filled icon buttons.
  1. Icon
  2. Container

Icon

Icons visually communicate the button’s action. Their meaning should be clear and unambiguous. Browse popular icons

Default icon buttons should use filled icons.

Toggle buttons should use an outlined icon when unselected, and a filled version of the icon when selected.

“Heart” icon in a restaurant app.
Ensure the meaning of the icon is clear, such as a heart indicating Favorite

Icon accessibility requirements

For selected toggle buttons, if a filled version of an icon doesn’t exist, increase the icon weight to semibold. If semibold doesn’t provide enough visual change, use bold.

This is to ensure that selection is communicated through at least two properties, rather than just color. This requirement doesn't apply to default non-toggle buttons.

Selected, semi-bold icon in a text editing app.
Icons without a fill should be semibolded when selected

Container

The container provides increased contrast and hierarchy in places that need more visual separation from the background or other elements.

Container separating a video call preview with actions you can take.
The container provides visual separation from the background image

Placement ​

Icon buttons are commonly used in other components, such as app barsApp bars contain page navigation and information at the top of a screenMore on app bars and cardsCards display content and actions about a single subject.More on cards.

These buttons should be used for common, easily understandable actions.

Only use a few icon buttons at once.

App bar with icon buttons.
App bars often contain icon buttons

In dense layouts, group popular actions by placing many icon buttons next to each other in components like a toolbarToolbars display frequently used actions relevant to the current page.More on toolbars or button groupButton groups organize buttons and add interactions between them.More on button groups.

These components draw attention or add interaction between buttons.

Toolbar with icon buttons and FAB.
A toolbar is a collection of icon buttons and other components

Behavior ​

Hover

On hover, the icon button displays a tooltip describing its action, rather than the name of the icon itself.

The tooltip label text should be clear and concise

Selection

Toggle icon buttons allow a single choice to be selected or deselected, such as adding or removing something from favorites.

When placed in a button groupButton groups organize buttons and add interactions between themMore on button groups, icon buttons change shape to help the selected button stand out.

More on button groups

Do Use toggle icon buttons when the icon can be selected
Don’t Don’t use toggle icon buttons for actions that don’t have a selected state, such as an icon button for an overflow menu

The icon should become filled to represent selection.

If a filled version of the icon doesn't exist, use semibold weight instead.

When making a selection, such as bookmarking or saving a video, the icon transitions from outlined (unselected) to filled (selected)
Pager
Previous pageIcon buttons: Specs
Next pageIcon buttons: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/icon-buttons/guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google