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: Specs ​

Icon buttons help people take actions with a single tap

Variants ​

Side by side view of default and toggle icon buttons.
  1. Default icon button
  2. Toggle icon button

VariantM3M3 Expressive
DefaultAvailableAvailable
Toggle (selection)AvailableAvailable

Configurations ​

Side by side view of size, shape, color, and width variations.
  1. Five sizes
  2. Two shapes
  3. Four color styles
  4. Three widths

CategoryOptionsM3M3 Expressive
SizeSmall (default)AvailableAvailable
XS, M, L, XL--Available
ShapeRound (default)AvailableAvailable
Square--Available
ColorFilled (default), tonal, outlined, standardAvailableAvailable
WidthDefaultAvailableAvailable
Narrow, wide--Available

Tokens & specs ​

Icon button token sets are organized by common tokens, color, and size. Select the token set from the table’s menu. Learn about design tokens

Icon button - Color - Filled ​

Theme
Contrast

Icon button - Color - Tonal ​

Theme
Contrast

Icon button - Color - Outlined ​

Theme
Contrast

Icon button - Color - Standard ​

Theme
Contrast

Icon button - Size - Xsmall ​

Motion scheme
TokenValue
Icon button xsmall container height32dp
Icon button xsmall icon size20dp
Icon button xsmall narrow leading space4dp
Icon button xsmall narrow trailing space4dp
Icon button xsmall default leading space6dp
Icon button xsmall default trailing space6dp
Icon button xsmall wide leading space10dp
Icon button xsmall wide trailing space10dp
Icon button xsmall container shape roundCircular
Icon button xsmall container shape square12dp
Icon button xsmall outline width1dp
Icon button xsmall shape pressed morph8dp
Icon button xsmall shape spring animation damping0.9
Icon button xsmall shape spring animation stiffness1400
Icon button xsmall selected container shape round12dp
Icon button xsmall selected container shape squareCircular

Icon button - Size - Small ​

Motion scheme
TokenValue
Icon button small container height40dp
Icon button small icon size24dp
Icon button small narrow leading space4dp
Icon button small narrow trailing space4dp
Icon button small default leading space8dp
Icon button small default trailing space8dp
Icon button small wide leading space14dp
Icon button small wide trailing space14dp
Icon button small container shape roundCircular
Icon button small container shape square12dp
Icon button small outline width1dp
Icon button small shape pressed morph8dp
Icon button small shape spring animation damping0.9
Icon button small shape spring animation stiffness1400
Icon button small selected container shape round12dp
Icon button small selected container shape squareCircular

Icon button - Size - Medium ​

Motion scheme
TokenValue
Icon button medium container height56dp
Icon button medium icon size24dp
Icon button medium narrow leading space12dp
Icon button medium narrow trailing space12dp
Icon button medium default leading space16dp
Icon button medium default trailing space16dp
Icon button medium wide leading space24dp
Icon button medium wide trailing space24dp
Icon button medium container shape roundCircular
Icon button medium container shape square16dp
Icon button medium outline width1dp
Icon button medium shape pressed morph12dp
Icon button medium shape spring animation damping0.9
Icon button medium shape spring animation stiffness1400
Icon button medium selected container shape round16dp
Icon button medium selected container shape squareCircular

Icon button - Size - Large ​

Motion scheme
TokenValue
Icon button large container height96dp
Icon button large icon size32dp
Icon button large narrow leading space16dp
Icon button large narrow trailing space16dp
Icon button large default leading space32dp
Icon button large default trailing space32dp
Icon button large wide leading space48dp
Icon button large wide trailing space48dp
Icon button large container shape roundCircular
Icon button large container shape square28dp
Icon button large outline width2dp
Icon button large shape pressed morph16dp
Icon button large shape spring animation damping0.9
Icon button large shape spring animation stiffness1400
Icon button large selected container shape round28dp
Icon button large selected container shape squareCircular

Icon button - Size - Xlarge ​

Motion scheme
TokenValue
Icon button xlarge container height136dp
Icon button xlarge icon size40dp
Icon button xlarge narrow leading space32dp
Icon button xlarge narrow trailing space32dp
Icon button xlarge default leading space48dp
Icon button xlarge default trailing space48dp
Icon button xlarge wide leading space72dp
Icon button xlarge wide trailing space72dp
Icon button xlarge container shape roundCircular
Icon button xlarge container shape square28dp
Icon button xlarge outline width3dp
Icon button xlarge shape pressed morph16dp
Icon button xlarge shape spring animation damping0.9
Icon button xlarge shape spring animation stiffness1400
Icon button xlarge selected container shape round28dp
Icon button xlarge selected container shape squareCircular

Anatomy ​

Diagram indicating anatomy of filled icon button.
  1. Icon
  2. Container

Color ​

Color values are implemented through design tokensDesign tokens are the building blocks of all UI elements. The same tokens are used in designs, tools, and code.More on tokens. For designers, this means working with color values that correspond with tokens; in implementation, a color value will be a token that references a value.

There are four built-in color styles: filled, tonal, outlined, and standard. Default and toggle buttons use different color roles per style.

TIP

These color roles were chosen to create design coherence and familiarity. Other color roles can be used as long as the container and text have a 3:1 contrast ratio. For example, tertiary and on tertiary.

Color roles of default and toggle buttons in 4 visual styles.

A: Filled, B: Tonal, C: Outlined, D: Standard

  1. Default
  2. Toggle, unselected
  3. Toggle, selected

1. Default2. Toggle, unselected3. Toggle, selected
Filled container
Filled icon
Primary
On primary
Surface container
On surface variant
Primary
On primary
Tonal container
Tonal icon
Secondary container
On secondary container
Secondary container
On secondary container
Secondary
On secondary
Outlined container
Outlined icon
Outline variant (outline)
On surface variant
Outline variant (outline)
On surface variant
Inverse surface
Inverse on surface
Standard iconOn surface variantOn surface variantPrimary

States ​

StatesStates show the interaction status of a component or UI element.More on states are visual representations used to communicate the status of a component or interactive element. State layers slightly change button color. Disabled states have different base colors. View tokens for details

Filled button states ​

Default ​


5 states of filled icon button.
  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Toggle ​


5 states of filled toggle icon button.

A: Unselected. B: Selected

  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Tonal button states ​

Default ​


5 states of tonal icon button.
  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Toggle ​


5 states of tonal toggle icon button.

A: Unselected. B: Selected

  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Outlined button states ​

Default ​


5 states of outlined icon button.
  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Toggle ​


5 states of outlined toggle icon button.

A: Unselected. B: Selected

  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Standard icon button states ​

The standard icon button’s container is invisible at rest, but visible when the state layer is applied.

Default ​


5 states of standard icon button.
  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Toggle ​


5 states of standard toggle icon button.

A: Unselected. B: Selected

  1. Enabled
  2. Disabled (10% state layer)
  3. Hovered (8% state layer)
  4. Focused (10% state layer)
  5. Pressed (10% state layer)

Shape morph ​

Pressed state

While pressed, icon buttons can morph to become more square.

Both round and square icon buttons should have the same pressed shape radius.

The corner radius value differs for each button size. See full icon button corner measurements

Shape changes for round and square icon buttons in 3 states.

A. Round, B. Square

  1. Enabled
  2. Hovered
  3. Pressed

When selected

In addition to changing shape when pressed, toggle icon buttons also change the resting shape from round (unselected) to square (selected) by default.

If the resting shape is square, the selected shape should be round.

Shape changes for round and square toggle icon buttons in 3 states.

A. Round, B. Square

  1. Enabled
  2. Hovered
  3. Pressed
  4. Selected

Measurements ​

Diagram of 5 sizes of icon buttons in 4 widths.

A. Extra small B. Small C. Medium D. Large E. Extra large

  1. Icon size
  2. Default width size
  3. Narrow width size
  4. Wide width size

Target sizes

Extra small and small icon buttons must have a target size of 48x48dp or larger to be accessible.

Diagram of target sizes.

A. Extra small icon button size B. Small icon button size

  1. Narrow width
  2. Default width
  3. Wide width

Button corner radius ​


Diagram of icon button corner radius.

XSSMLXL
A. Round buttonFullFullFullFullFull
B. Square button12dp12dp16dp28dp28dp
C. Pressed state8dp8dp12dp16dp16dp

Baseline tokens ​

Use the table's menu to select a token set. Filled, tonal, and outlined icon button tokens are now deprecated in favor of the new token sets. All other tokens are still available in the module at the top of the page.

[Deprecated] Icon button - Filled ​

Theme
Contrast

[Deprecated] Icon button - Tonal ​

Theme
Contrast

[Deprecated] Icon button - Outlined ​

Theme
Contrast
Pager
Previous pageIcon buttons: Overview
Next pageIcon buttons: Guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

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

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google