Usage guidelines
- Interface space is limited. Prioritize using a Button if space is available.
- Triggering a Modal to complete a related task.
- Creating visual separation of actions in text-heavy content.
- Lower-emphasis actions that don't impede users from completing a task.
- Displaying icons that don't have actions associated with them. Use an Icon instead.
- Displaying multiple IconButtons on a surface that uses the same icon for different actions.
- Text is better suited to convey the action and/or the icon isn't quickly recognizable by users.
- Destructive, high-emphasis actions, e.g "delete", "remove".
Best practices
- Avoid using a floating icon button if it obscures important information on the screen.
- IconButton on mobile should primarily utilize the lg (44dp) size as the increased size will better accommodate tapping with a finger.
For general IconButton best practices, refer to the IconButton web documentation.
Accessibility
People use Android’s accessibility features, such as TalkBack and dynamic text sizing to personalize how they interact with their device. Supporting these personalizations ensures that everyone has a great user experience. See Material Design and development documentation about accessibility for Android:
Accessbile design on Android
Accessible development on Android
Design tokens
Use these tokens for applying size and color styles to IconButton.
Please note: Icons on IconButton have a limited range of colors and sizes compared to regular icons, as they are different components and have particular usage cases. See Icon for additional information.
Anatomy
IconButtons use icons instead of text to convey available actions on a screen. Some buttons are specialized for particular tasks, such as navigation or presenting menus. Icons(.svg viewbox) dimensions are the same for all icons regardless of the size of the vector asset inside of the container. See Icon for more information.
Variants
Size
Size specs: Container
Size specs: Icon
Size use cases
- lg (44dp)
Large is the only size that should be used on Pinner surfaces. - md (32dp)
Medium is the size used on more dense UI such as business surfaces or internal tools. - sm (24dp)
Small IconButton should be used sparingly and only in places where the UI is very dense.
Color
Icon colors are semantic—they have a specific meaning and aren't arbitrary. There is no disabled color for icons, as that is handled by the button state that an icon is in.
Light mode
Dark mode
Elevation
For elevated IconButton, we suggest using the IconButtonFloating component (Android documentation in progress). See the IconButtonFloating web for reference.
Writing
For writing best practices, refer to the content standards.
- Use a descriptive label to describe the IconButton action by beginning with a verb
- Use the words "image" or "icon" in the description label; instead, prefer to use verbs that describe the action, e.g. "Save" or "Edit"