Icon buttons: Specs
Icon buttons help people take actions with a single tap
Variants

- Default icon button
- Toggle icon button
| Variant | M3 | M3 Expressive |
|---|---|---|
| Default | Available | Available |
| Toggle (selection) | Available | Available |
Configurations

- Five sizes
- Two shapes
- Four color styles
- Three widths
| Category | Options | M3 | M3 Expressive |
|---|---|---|---|
| Size | Small (default) | Available | Available |
| XS, M, L, XL | -- | Available | |
| Shape | Round (default) | Available | Available |
| Square | -- | Available | |
| Color | Filled (default), tonal, outlined, standard | Available | Available |
| Width | Default | Available | Available |
| 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
Icon button - Color - Tonal
Icon button - Color - Outlined
Icon button - Color - Standard
Icon button - Size - Xsmall
| Token | Value |
|---|---|
| Icon button xsmall container height | 32dp |
| Icon button xsmall icon size | 20dp |
| Icon button xsmall narrow leading space | 4dp |
| Icon button xsmall narrow trailing space | 4dp |
| Icon button xsmall default leading space | 6dp |
| Icon button xsmall default trailing space | 6dp |
| Icon button xsmall wide leading space | 10dp |
| Icon button xsmall wide trailing space | 10dp |
| Icon button xsmall container shape round | Circular |
| Icon button xsmall container shape square | 12dp |
| Icon button xsmall outline width | 1dp |
| Icon button xsmall shape pressed morph | 8dp |
| Icon button xsmall shape spring animation damping | 0.9 |
| Icon button xsmall shape spring animation stiffness | 1400 |
| Icon button xsmall selected container shape round | 12dp |
| Icon button xsmall selected container shape square | Circular |
Icon button - Size - Small
| Token | Value |
|---|---|
| Icon button small container height | 40dp |
| Icon button small icon size | 24dp |
| Icon button small narrow leading space | 4dp |
| Icon button small narrow trailing space | 4dp |
| Icon button small default leading space | 8dp |
| Icon button small default trailing space | 8dp |
| Icon button small wide leading space | 14dp |
| Icon button small wide trailing space | 14dp |
| Icon button small container shape round | Circular |
| Icon button small container shape square | 12dp |
| Icon button small outline width | 1dp |
| Icon button small shape pressed morph | 8dp |
| Icon button small shape spring animation damping | 0.9 |
| Icon button small shape spring animation stiffness | 1400 |
| Icon button small selected container shape round | 12dp |
| Icon button small selected container shape square | Circular |
Icon button - Size - Medium
| Token | Value |
|---|---|
| Icon button medium container height | 56dp |
| Icon button medium icon size | 24dp |
| Icon button medium narrow leading space | 12dp |
| Icon button medium narrow trailing space | 12dp |
| Icon button medium default leading space | 16dp |
| Icon button medium default trailing space | 16dp |
| Icon button medium wide leading space | 24dp |
| Icon button medium wide trailing space | 24dp |
| Icon button medium container shape round | Circular |
| Icon button medium container shape square | 16dp |
| Icon button medium outline width | 1dp |
| Icon button medium shape pressed morph | 12dp |
| Icon button medium shape spring animation damping | 0.9 |
| Icon button medium shape spring animation stiffness | 1400 |
| Icon button medium selected container shape round | 16dp |
| Icon button medium selected container shape square | Circular |
Icon button - Size - Large
| Token | Value |
|---|---|
| Icon button large container height | 96dp |
| Icon button large icon size | 32dp |
| Icon button large narrow leading space | 16dp |
| Icon button large narrow trailing space | 16dp |
| Icon button large default leading space | 32dp |
| Icon button large default trailing space | 32dp |
| Icon button large wide leading space | 48dp |
| Icon button large wide trailing space | 48dp |
| Icon button large container shape round | Circular |
| Icon button large container shape square | 28dp |
| Icon button large outline width | 2dp |
| Icon button large shape pressed morph | 16dp |
| Icon button large shape spring animation damping | 0.9 |
| Icon button large shape spring animation stiffness | 1400 |
| Icon button large selected container shape round | 28dp |
| Icon button large selected container shape square | Circular |
Icon button - Size - Xlarge
| Token | Value |
|---|---|
| Icon button xlarge container height | 136dp |
| Icon button xlarge icon size | 40dp |
| Icon button xlarge narrow leading space | 32dp |
| Icon button xlarge narrow trailing space | 32dp |
| Icon button xlarge default leading space | 48dp |
| Icon button xlarge default trailing space | 48dp |
| Icon button xlarge wide leading space | 72dp |
| Icon button xlarge wide trailing space | 72dp |
| Icon button xlarge container shape round | Circular |
| Icon button xlarge container shape square | 28dp |
| Icon button xlarge outline width | 3dp |
| Icon button xlarge shape pressed morph | 16dp |
| Icon button xlarge shape spring animation damping | 0.9 |
| Icon button xlarge shape spring animation stiffness | 1400 |
| Icon button xlarge selected container shape round | 28dp |
| Icon button xlarge selected container shape square | Circular |
Anatomy

- Icon
- 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.

A: Filled, B: Tonal, C: Outlined, D: Standard
- Default
- Toggle, unselected
- Toggle, selected
| 1. Default | 2. Toggle, unselected | 3. 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 icon | On surface variant | On surface variant | Primary |
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 detailsFilled button states
Default

- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- Pressed (10% state layer)
Toggle

A: Unselected. B: Selected
- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- Pressed (10% state layer)
Tonal button states
Default

- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- Pressed (10% state layer)
Toggle

A: Unselected. B: Selected
- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- Pressed (10% state layer)
Outlined button states
Default

- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- Pressed (10% state layer)
Toggle

A: Unselected. B: Selected
- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- 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

- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- Pressed (10% state layer)
Toggle

A: Unselected. B: Selected
- Enabled
- Disabled (10% state layer)
- Hovered (8% state layer)
- Focused (10% state layer)
- 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

A. Round, B. Square
- Enabled
- Hovered
- 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.

A. Round, B. Square
- Enabled
- Hovered
- Pressed
- Selected
Measurements

A. Extra small B. Small C. Medium D. Large E. Extra large
- Icon size
- Default width size
- Narrow width size
- Wide width size
Target sizes
Extra small and small icon buttons must have a target size of 48x48dp or larger to be accessible.

A. Extra small icon button size B. Small icon button size
- Narrow width
- Default width
- Wide width
Button corner radius

| XS | S | M | L | XL | |
|---|---|---|---|---|---|
| A. Round button | Full | Full | Full | Full | Full |
| B. Square button | 12dp | 12dp | 16dp | 28dp | 28dp |
| C. Pressed state | 8dp | 8dp | 12dp | 16dp | 16dp |
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.