Icon buttons: Guidelines
Icon buttons help people take actions with a single tap
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

Color
There are four icon button color styles, in order of emphasis:
- Filled
- Tonal
- Outlined
- Standard
For the highest emphasis, use the filled style. For the lowest emphasis, use standard.

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.


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

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.

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.

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.

Anatomy

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

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.

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

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.

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.

Behavior
Hover
On hover, the icon button displays a tooltip describing its action, rather than the name of the icon itself.
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.
The icon should become filled to represent selection.
If a filled version of the icon doesn't exist, use semibold weight instead.