Skip to content
Material Design 2
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

Material System

Introduction

Material studies

About our Material studies

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Material Foundation

Environment

Surfaces

Elevation

Light and shadows

Layout

Understanding layout

Pixel density

Responsive layout grid

Spacing methods

Component behavior

Applying density

Navigation

Understanding navigation

Navigation transitions

Search

Color

The color system

Applying color to UI

Color usage

Text legibility

Dark theme

Typography

The type system

Understanding typography

Language support

Sound

About sound

Applying sound to UI

Sound attributes

Sound choreography

Iconography

Product icons

System icons

Animated icons

Shape

About shape

Shape and hierarchy

Shape as expression

Shape and motion

Applying shape to UI

Motion

Understanding motion

The motion system

Speed

Choreography

Customization

Interaction

Gestures

Selection

States

Communication

Confirmation & acknowledgement

Data formats

Data visualization

Empty states

Help & feedback

Imagery

Launch screen

Onboarding

Offline states

Writing

Machine learning

Machine learning patterns

Object detection: live camera

Object detection: static image

Barcode Scanning

Material Guidelines

Material Theming

Overview

Implementing your theme

Usability

Accessibility

Bidirectionality

Platform guidance

Android bars

Android fingerprint

Android haptics

Android icons

Android navigating between apps

Android notifications

Android permissions

Android slices

Android split-screen

Android swipe-to-refresh

Android text selection toolbar

Android widget

Cross-platform adaptation

Components

App bars: bottom

App bars: top

Backdrop

Banners

Bottom navigation

Buttons

Buttons: floating action button

Cards

Checkboxes

Chips

Data tables

Date pickers

Dialogs

Dividers

Image lists

Lists

Menus

Navigation drawer

Navigation rail

Progress indicators

Radio buttons

Sheets: bottom

Sheets: side

Sliders

Snackbars

Switches

Tabs

Text fields

Time pickers

Tooltips

On this page

Buttons ​

Buttons allow users to take actions, and make choices, with a single tap.

Interactive demo ​

This demo lets you preview the button component, its variations, and configuration options. Each tab displays a different type of button.

Usage ​

Buttons communicate actions that users can take. They are typically placed throughout your UI, in places like:

  • Dialogs
  • Modal windows
  • Forms
  • Cards
  • Toolbars

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Comprehension

Improving comprehension through intuitive actions

Related article

Principles ​


Button principle: identifiable

Identifiable

Buttons should indicate that they can trigger an action.

Button principle: findable

Findable

Buttons should be easy to find among other elements, including other buttons.

Button principle: clear

Clear

A button’s action and state should be clear.

Types ​


Text buttons are typically used for less important actions
1. Text button (low emphasis)
Text buttons are typically used for less important actions.

2. Outlined Button (medium emphasis)
Outlined buttons are used for more emphasis than text buttons due to the stroke.

3. Contained button (high emphasis)
Contained buttons have more emphasis, as they use a color fill and shadow.

4. Toggle button
Toggle buttons group a set of actions using layout and spacing. They’re used less often than other button types.

Anatomy ​

Buttons contain one required element and four optional elements.

Anatomy spec diagram
1. Text button
A. Text label
C. Icon (optional)

2. Outlined button
A. Text label
B. Container
C. Icon (optional)

3. Contained button
A. Text label
B. Container
C. Icon (optional)

4. Toggle button
A. Text label
C. Icon (optional)

Text label ​

Text buttons and contained buttons use text labels, which describe the action that will occur if a user taps a button. If a text label is not used, an icon should be present to signify what the button does.

By default Material uses capitalized button text labels (for languages that have capitalization). This is to distinguish the text label from surrounding text. If a text button does not use capitalization for button text, find another characteristic to distinguish it such as color, size, or placement.

Do: use capitalization for languages that allow capitalization

Do

Use capitalization for languages that allow capitalization.
Don’t wrap text

Don't

Don’t wrap text. For maximum legibility, a text label should remain on a single line.

Hierarchy and placement ​

Hierarchy ​

A single, prominent button ​

A layout should contain a single prominent button that makes it clear that other buttons have less importance in the hierarchy. This high-emphasis button commands the most attention.

Other buttons ​

An app can show more than one button in a layout at a time, so a high-emphasis button can be accompanied by medium- and low-emphasis buttons that perform less important actions. When using multiple buttons, ensure the available state of one button doesn’t look like the disabled state of another.

A button’s level of emphasis helps determine its appearance, typography, and placement
A button’s level of emphasis helps determine its appearance, typography, and placement.

Placement ​

Multiple button types can be used to express different emphasis levels.

An extended floating action button for the highest emphasis
This screen layout uses:
1. An extended floating action button for the highest emphasis
2. A contained button for high emphasis
3. A text button for low emphasis

Do: in a bottom bar, when using multiple buttons

Do

In a bottom bar, when using multiple buttons, indicate the more important action by placing it in a contained button (next to a text button).
Don't: avoid using two contained buttons next to one another if they don’t have the same fill color

Don't

Avoid using two contained buttons next to one another if they don’t have the same fill color.

Do: in a bottom bar, when using multiple buttons

Do

In a bottom bar, when using multiple buttons, you can place an outlined button (medium emphasis) next to a contained button (high emphasis).
Do: you can place a text button (low emphasis) next to an outlined button (medium emphasis)

Do

When using multiple buttons in a bottom bar, you can place a text button (low emphasis) next to an outlined button (medium emphasis).

Do: use a contained button in a bottom sheet next to other important details

Do

Use a contained button in a bottom sheet next to other important details.

Don’t place a button below another button if there is space to place them side by side

Don't

Don’t place a button below another button if there is space to place them side by side.

Floating Action Button

A floating action button (FAB) represents the primary action for a screen.

Related article

Behavior ​

Scaling and adaptation ​

When scaling layouts for large screen devices, buttons can adapt their visual presentation, alignment, and arrangement to fit different contexts and user needs.

Container properties ​

Buttons are typically placed in containers such as cards or dialogs. As a parent container scales to adapt to different screen sizes, a button’s size, position, and alignment within the container can also change.

Buttons can be aligned left, right, or center as the parent container scales.

Container properties: centered

A button’s position and size should scale in relationship to its container.

Container properties: full width

Arrangement ​

Define the position and alignment of button elements such as text and icons in relationship to their container. For example, the icon and text label within a button remain centered and anchored to each other as the button width scales.

Do: group internal elements so that they scale appropriately

Do

Group internal elements so that they scale appropriately. Icons and text labels remain centered when button width increases.
Don’t ungroup elements inside of a button container

Don't

Don’t ungroup elements inside of a button container. This can lead to unwanted movement, such as the icon and label anchoring to opposite sides of the button.

The size and placement of buttons can change as parent containers, such as cards, adapt for larger screens.

Two buttons scaling to accommodate different component sizes
Two buttons scaling to accommodate different component sizes.

Text button ​

Usage ​

Text buttons are typically used for less-pronounced actions, including those located:

  • In dialogs
  • In cards

In cards, text buttons help maintain an emphasis on card content.

Usage: text button
Text button

Use a text button in snackbars
Use a text button in snackbars.
A text button against an image background
A text button against an image background.

Text label ​

A button’s text label is the most important element on a button, as it communicates the action that will be performed when the user touches it.

Text label using a distinct action
Text label using a distinct action.

Caution: text labels need to be distinct from other elements

Caution

Text labels need to be distinct from other elements. If the text label isn’t fully capitalized, it should use a different color, style, or layout from other text.
Don't: avoid text labels that are too long

Don't

Avoid text labels that are too long. They should be concise.

Placement ​

Text buttons are often embedded in contained components like cards and dialogs, in order to relate themselves to the component in which they appear. Because text buttons don’t have a container, they don’t distract from nearby content.

Dialogs use text buttons because the absence of a container helps unify the action with the dialog text
Dialogs use text buttons because the absence of a container helps unify the action with the dialog text. Align text buttons to the right edge for left-to-right scripts.

Text buttons minimize distraction from card content
Text buttons minimize distraction from card content.

States ​

Text buttons can be placed in front of a variety of backgrounds. Until the button is interacted with, its container isn’t visible.

To maintain accessibility, Material Design provides baseline opacity values for the color overlays used by states. A brand can adjust opacity values to suit its color scheme.

Text button states
Text button states

States

Visual representations used to communicate the status of a component or interactive element.

Related article

Outlined button ​

Usage ​

Outlined buttons are medium-emphasis buttons. They contain actions that are important, but aren’t the primary action in an app.

Alternatives ​

Outlined buttons are also a lower emphasis alternative to contained buttons, or a higher emphasis alternative to text buttons.

Alternatives: outlined button

Container ​

Outlined buttons display a stroke around a text label. Stroke can be represented in different ways:

  • Set a button’s width to be the size of the text label, with 16dp padding on the left and right
  • Set the button’s relative position to the responsive layout grid

In a resting state, outlined buttons should display containment with a stroke and no fill.

Container: outlined button
Outlined button

Do: an outlined button’s width is dynamically set to fit the text label

Do

An outlined button’s width is dynamically set to fit the text label.
Don't: an outlined button’s width shouldn’t be narrower than the button’s text length

Don't

An outlined button’s width shouldn’t be narrower than the button’s text length.

Caution: distinguish text when using outlined buttons in front of images

Caution

Distinguish text when using outlined buttons in front of images. This image uses a light purple scrim to make text easy to read in the outlined button.

States ​

Outlined buttons can be placed on top of a variety of backgrounds. Its container is transparent and until the button is interacted with, a color isn’t visible.

To maintain accessibility, Material Design provides baseline opacity values for the color overlays used by states. A brand can adjust opacity values to suit its color scheme.

Outlined button states
Outlined button states

States

Visual representations used to communicate the status of a component or interactive element.

Related article

Contained button ​

Usage ​

Contained buttons are high-emphasis, distinguished by their use of elevation and fill. They contain actions that are primary to your app.

Usage: a contained button
A contained button
Do: text labels can be written in sentence case, as long as the button is clearly distinguishable from elements around it

Do

Text labels can be written in sentence case, as long as the button is clearly distinguishable from elements around it.

Container ​

Contained buttons display a container around a text label. Containers can be represented in different ways:

  • Set container width to the size of the text label with 16dp padding on the left and right
  • Set the container’s relative position to the responsive layout grid

Contained buttons should display containers with a solid color.

A contained button with solid color
A contained button with solid color

Do: a button container’s width is dynamically set to fit its text label

Do

A button container’s width is dynamically set to fit its text label.
Don't: a button container’s width shouldn’t be narrower than its text

Don't

A button container’s width shouldn’t be narrower than its text.

Button container width can be set according to the responsive layout grid.

Contained button in a responsive layout grid
Contained button in a responsive layout grid

Icon ​

Contained buttons can place icons next to text labels to both clarify an action and call attention to a button.

Do: use icons that clearly communicate their meaning

Do

Use icons that clearly communicate their meaning.

Don’t vertically align an icon and text in the center of a contained button

Don't

Don’t vertically align an icon and text in the center of a contained button.
Don’t use two icons in the same button

Don't

Don’t use two icons in the same button.

Shadow & elevation ​

Buttons at higher elevations typically appear more prominent in a design. On press, elevated buttons lift up and the container displays touch feedback.

Higher elevation increases the prominence of a contained button
Higher elevation increases the prominence of a contained button.

States ​

Recommended opacity values for button container fill colors can be found in the states guidelines. An app can alter the overlay values of the button to suit a brand’s color palette.

Contained button states
Contained button states

States

Visual representations used to communicate the status of a component or interactive element.

Related article

Toggle button ​

Usage ​

Toggle buttons can be used to group related options. To emphasize groups of related toggle buttons, a group should share a common container.

Selected action ​

Only one option in a group of toggle buttons can be selected and active at a time. Selecting one option deselects any other.

These toggle buttons present options for aligning text to the left, right, and center
These toggle buttons present options for aligning text to the left, right, and center.

Icons can be used as toggle buttons when they allow selection, or deselection
Icons can be used as toggle buttons when they allow selection, or deselection, of a single choice, such as marking an item as a favorite.

States ​

Active and available toggle buttons ​

A toggle button’s state makes it clear which button is active. Hover and focus states express the available selection options for buttons in a toggle group.

Disabled toggle buttons ​

Toggle buttons that cannot be selected can either be given a disabled state, or be hidden.

Disabled toggle buttons: toggle button states
Toggle button states

States

Visual representations used to communicate the status of a component or interactive element.

Related article

Theming ​

Crane Material theme ​

This travel app’s buttons have been customized using Material Theming. Areas of customization include color, typography, and shape.

Crane’s customized buttons
Crane’s customized buttons

Crane

A travel app that uses Material Design components and Material Theming to create a personalized on-brand experience.

Related link

The color system

Create a color theme that reflects your brand or style

Related article

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Color ​

Crane’s buttons use custom color on two elements: the container and text.

Crane Material theme: color
ElementCategoryAttributeValue
ContainerPrimaryColor
Opacity
#5C1349
100%
TextOn PrimaryColor
Opacity
#FFFFFF
100%

Typography ​

Crane’s buttons use custom typography for the button text.

Crane Material theme: typography
ElementCategoryAttributeValue
TextButtonTypeface
Font
Size
Case
Raleway
SemiBold
14
All caps

About shape

Direct attention, identify components, communicate state, and express brand

Related link

Understanding typography

Typography is critical in establishing hierarchy and expressing brand presence that supports an effective digital experience.

Related article

Shape ​

Crane’s button containers have custom corner shapes, with a 50% corner radius. *Crane buttons are in the small component shape category, and they use a custom size.

Crane Material theme: shape
ElementCategoryAttributeValue
ContainerOverride*Family
Size
Rounded
50%

Fortnightly Material theme ​

This news app’s buttons have been customized using Material Theming. Areas of customization include color and typography.

Fortnightly’s customized buttons
Fortnightly’s customized buttons

Fortnightly

A news app that uses Material Design components and Material Theming to create an on-brand, content-focused experience.

Related article

The color system

Create a color theme that reflects your brand or style

Related article

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Color ​

Fortnightly’s buttons use custom color on two elements: background and text.

Fortnightly Material theme: color
ElementCategoryAttributeValue
BackgroundBackgroundColor
Opacity
#FFFFFF
100%
TextPrimaryColor
Opacity
#661FFF
100%

Understanding typography

Typography is critical in establishing hierarchy and expressing brand presence that supports an effective digital experience.

Related article

Typography ​

Fortnightly’s buttons use custom typography for the button text.

Fortnightly Material theme: typography
ElementCategoryAttributeValue
TextButtonTypeface
Font
Size
Case
Libre Franklin
ExtraBold
14
Sentence case

Rally Material theme ​

This personal finance app’s buttons have been customized using Material Theming. Areas of customization include color and typography.

Rally’s customized buttons
Rally’s customized buttons

Rally

Rally is a personal finance app that demonstrates how Material Design can be used for finance.

Related article

The color system

Create a color theme that reflects your brand or style

Related article

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Color ​

Rally’s buttons use custom color on two elements: background and text.

Rally Material theme: color
ElementCategoryAttributeValue
BackgroundSurfaceColor
Opacity
#3C3C46
100%
TextPrimaryColor
Opacity
#FFFFFF
100%

Understanding typography

Typography is critical in establishing hierarchy and expressing brand presence that supports an effective digital experience.

Related article

Typography ​

Rally’s buttons use custom typography for the button text.

Rally Material theme: typography
ElementCategoryAttributeValue
TextButtonTypeface
Font
Size
Case
Roboto Condensed
Bold
14
All caps

Posivibes Material theme ​

This social media app’s buttons have been customized using Material Theming. Areas of customization include color, typography, and shape.

Posivibes Material theme: posivibe’s customized buttons
Posivibe’s customized buttons

The color system

Create a color theme that reflects your brand or style

Related article

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Color ​

Posivibe’s buttons use custom color on two elements: the container stroke and text.

Posivibes Material theme: color
ElementCategoryAttributeValue
Container strokeSecondaryColor
Opacity
#000000
100%
TextPrimaryColor
Opacity
#000000
100%

Typography ​

Posivibe’s buttons use custom typography for the button text.

Posivibes Material theme: typography
ElementCategoryAttributeValue
TextButtonTypeface
Font
Size
Case
Roboto Condensed
Bold
14
All caps

About shape

Direct attention, identify components, communicate state, and express brand

Related link

Understanding typography

Typography is critical in establishing hierarchy and expressing brand presence that supports an effective digital experience.

Related article

Shape ​

Posivibe’s button containers have custom corner shapes, with 0dp long cut corners.

Posivibes Material theme: shape
ElementCategoryAttributeValue
ContainerSmall componentFamily
Size
Cut
0;0;0;0dp

Reply Material theme ​

This email app’s buttons have been customized using Material Theming. Areas of customization include color and typography.

Reply’s customized buttons
Reply’s customized buttons.

Reply

Reply is an email app that uses Material Design components and Material Theming to create an on-brand communication experience.

Related article

The color system

Create a color theme that reflects your brand or style

Related article

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Color ​

Reply’s buttons use custom color on four elements: background, icon, icon fill, and text.

Reply Material theme: color
ElementCategoryAttributeValue
BackgroundSurfaceColor
Opacity
#FFFFFF
100%
IconPrimaryColor
Opacity
#344955
100%
Icon fillOn PrimaryColor
Opacity
#344955
30%
TextPrimaryColor
Opacity
#344955
100%

Understanding typography

Typography is critical in establishing hierarchy and expressing brand presence that supports an effective digital experience.

Related article

Typography ​

Reply’s buttons use custom typography for the button text.

Reply Material theme: typography
ElementCategoryAttributeValue
TextButtonTypeface
Font
Size
Case
Work Sans
ExtraBold
15
All caps

Shrine Material theme ​

This retail app’s buttons have been customized using Material Theming. Areas of customization include color, typography, and shape.

Shrine’s customized buttons
Shrine’s customized buttons

Shrine

Shrine is a lifestyle and fashion brand that demonstrates how Material Design can be used in e-commerce.

Related article

The color system

Create a color theme that reflects your brand or style

Related article

Applying color to UI

In a UI, color has a variety of roles: from containing meaning, to expressing a look and feel.

Related article

Color ​

Shrine’s buttons use custom color on three elements: the container, icon, and text.

Shrine Material theme: color
ElementCategoryAttributeValue
ContainerPrimaryColor
Opacity
#FEDBD0
100%
IconOn PrimaryColor
Opacity
#442C2E
100%
TextOn PrimaryColor
Opacity
#442C2E
100%

Typography ​

Shrine’s buttons use custom typography for the button text.

Shrine Material theme: typography
ElementCategoryAttributeValue
TextButtonTypeface
Font
Size
Case
Rubik
Medium
14
All caps

Understanding typography

Typography is critical in establishing hierarchy and expressing brand presence that supports an effective digital experience.

Related article

About shape

Direct attention, identify components, communicate state, and express brand

Related link

Shape ​

Shrine’s button containers have custom corner shapes, with cut corner shapes.

Shrine Material theme: shape
ElementCategoryAttributeValue
ContainerSmall componentFamily
Size
Cut
4dp; 4dp; 4dp; 4dp

Specs ​


Contained button


C36min-width: 64dp1616

Contained button with icon


8121636min-width: 64dpC18

Outlined button


C161636min-width: 64dp1

Text button


36min-width: 64dp88C

Toggle buttons


481212121248124
Pager
Previous pageBottom navigation
Next pageButtons: floating action button

Released under the Apache-2.0

Copyright © 2018-Present Google

https://m2.material.io/components/buttons

Released under the Apache-2.0

Copyright © 2018-Present Google