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

Cards: Guidelines ​

Cards display content and actions about a single subject


3 variants of cards: elevated, filled, and outlined.

Usage ​

Use a card to display content and actions on a single topic.

Cards should be easy to scan for relevant and actionable information.

Elements like text and images should be placed on cards in a way that clearly indicates hierarchy.

Example card containing an image, title, text, and button.
Cards can display content and actions on a single topic

Cards can serve as entry points into deeper levels of detail or navigation, such as a music album or details on an upcoming vacation.

Example world tour card.
Card text and image show a clear hierarchy
Card displaying connected details about a world tour.
Use cards to display related information on a single subject

Cards can be displayed together in a grid, vertical list, or carouselCarousels show a collection of items that can be scrolled on and off the screen.More on carousels.

4 cards together in a grid layout.
Do Cards can be shown together
5 albums in a vertical list of cards.
Don't Don't force content into cards when spacing, headlines, or dividers would create a simpler visual hierarchy

There are three card variants:

  • ElevatedElevated cards have a drop shadow, providing more separation from the background than filled cards, but less than outlined cards
  • FilledFilled cards provide subtle separation from the background. This has less emphasis than elevated or outlined cards.
  • OutlinedOutlined cards have a visual boundary around their container. This can provide greater emphasis than the other types.

Each provides the same legibility and functionality, so the variant you use depends on style alone.

3 variants of cards.
  1. Elevated card
  2. Filled card
  3. Outlined card
Example elevated card.
Elevated cards have a drop shadow, providing more separation from the background than filled cards, but less than outlined cards
Example filled card.
Filled cards provide subtle separation from the background. This has less emphasis than elevated or outlined cards.
Example outlined card.
Outlined cards have a visual boundary around the container. This can provide greater emphasis than the other variants.

Anatomy ​

The card container is the only required element in a card. Card layouts can vary to support the kinds of content they contain. Below is a common configuration of elements.

Diagram labeling the 6 parts of card anatomy.
  1. Container
  2. Image
  3. Button
  4. Supporting text
  5. Subhead
  6. Headline

Container

Card containers hold all card elements. Their size is determined by the space those elements occupy. Card elevation is expressed by the container.

The card container is the only required element of a card. All other elements are optional.

3 card containers with various elements: 1 with all elements except a button. 1 with a container, headline, supporting text, button. 1 with a container, headline, supporting text, 2 buttons.
Card size is determined by the elements it contains

Content blocks

Card contents are grouped into blocks. Content can have different levels of visual emphasis depending on importance.

Card layouts vary to support the kinds of content they contain.

Diagram of card content blocks.
Cards can contain a headline, subhead, supporting text, media, and actions

Dividers

Dividers can separate regions in cards or indicate areas of a card that can expand.

A divider running the entire width of the card.
1. Use full-width dividers for content that can be expanded
An inset divider indented from the edge of card.
1. Use inset dividers, which don’t run the full width of a card, to separate related content

Media

Thumbnail
Cards can include thumbnails for an avatar or logo.

Image
Cards can include photos, illustrations, and other graphics, such as weather icons.

Video
Cards can include video.

A mobile chat app with: 5 cards with images, 1 card with a thumbnail avatar, and 1 card with a video.
Cards can contain thumbnails, images, and video

Text

Headline
Headline text often communicates the subject of the card, such as the name of a photo album or article.

Subhead
Subheads are smaller text elements, such as an article byline or a tagged location.

Supporting text
Supporting text includes body content, such as an article summary or a restaurant description.

A tablet email app with an email summary card with multiple text elements.
Headline, subhead, and supporting text in a card

Layering text, icons, and images

It isn’t recommended to place text or icons on images. If it’s necessary, ensure the background image provides sufficient contrast for the text to meet accessibilityAccessible design makes products usable for people with all kinds of abilities.More on accessibility standards.

Add a translucent scrim or bounding shape beneath the text or icon to help ensure proper contrast.

Layered text contrasts with the background image.
Caution Ensure that text on images meets accessible contrast standards
Icon within a bounding shape, placed on an image.
Caution When placing text or icons on images, consider using a bounding shape to ensure proper contrast

Actions

Primary action area

Cards can be one large touch target triggering an expanded detail screen.

The action area of a card contains rich media and supporting text.
Cards can include a primary action area that expands into a full-screen view

Buttons
Cards can include buttonsButtons let people take action and make choices with one tap.More on buttons for actions such as Learn more or Add to cart.

Icon buttons
Cards can include icon buttonsIcon buttons help people take minor actions with one tap.More on icon buttons for actions such as Save, Heart, or Leave a 4-star review.

Selection controls
Cards can also include chipsChips help people enter information, make selections, filter content, or trigger actions.More on chips, slidersSliders let users make selections from a range of values.More on sliders, checkboxesCheckboxes let users select one or more items from a list, or turn an item on or off.More on checkboxes, and other selection controls.

Linked text
There can be a link in the supporting text on a card.

Supplemental text and actions at the top and bottom of the card.
Cards can include multiple action areas containing buttons, links, and other controls
Album card with an option to give a star rating.
Cards can contain icon buttons like stars to rate content
Card to purchase tickets with choice chips for 3 event times.
Cards can contain choice chips in the action area
Card with slider to control a song’s volume.
Cards can contain a slider control in the action area

Overflow menu
Overflow menus contain related actions. They are typically placed in the upper-right or lower-right corner of a card.

2 cards: 1 with an overflow menu in the upper-right corner, the other with it in the lower right.
Overflow menus are usually located in the upper-right or lower-right corner of a card

Cards in a collection ​

Multiple cards can be grouped together into collections displayed in a grid, listLists are continuous, vertical indexes of text and images.More on lists, or carouselCarousels show a collection of items that can be scrolled on and off the screen.More on carousels.

By default, cards in a collection are coplanar. They share the same resting elevation unless they're picked up or draggedA dragged state communicates when a user presses and moves an element.More on dragged state.

9 cards in a grid layout.
Multiple cards can be grouped into collections with a shared resting elevation

Filtering and sorting

Card collections can be filtered in a variety of ways, including by date or alphabetical order. If a collection can be filtered, the filter must apply to each card in the collection.

Filter or sorting options should be placed outside of the card collection.

A sort-by-date option placed above a card collection.
Card collections can be filtered in a variety of ways, including by date:
1. A sort-by-date option is placed outside of the card collection

Organize card collections so that they'e easy to use. Their layoutLayout is the visual arrangement of elements on the screen.More on layout affects how they are perceived.

A template for an 8-card collection layout.
Place cards in a collection in a straightforward, easy-to-use manner

Grid

Cards can be displayed together in a grid.

Cards displayed in a grid

The default grid can be customized in code to show cards in staggered or mosaic grids.

5 menu item cards in a mosaic grid.
Custom mosaic grid
4 menu item cards in a staggered grid.
Custom staggered grid

Vertical list

Cards can be displayed together in a vertical list.

Cards can be shown in a vertical list

Carousel

Cards can be displayed together in a horizontal row or carouselCarousels show a collection of items that can be scrolled on and off the screen.More on carousels.

Cards displayed together in a horizontal row or carousel

Adaptive design ​

As cards scale to adapt to different breakpoints, their position and alignment can also change.

Cards and their elements can align left, right, or center as the layout scales.

2 cards on a mobile screen row expand to 4 cards on a tablet screen row.
Card position and alignment changes as the screen size changes

Ergonomics

Adjust the layoutLayout is the visual arrangement of elements on the screen.More on layout of cards to meet the ergonomic needs of large screens.

For example, a horizontally-oriented card in a compact breakpointWindow widths smaller than 600dp, such as a phone in portrait orientation.More on compact breakpoints may become a larger, vertically-oriented card in an expanded breakpointWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints, with more space for images and text on the larger screen.

Card sizes change from mobile to tablet, with larger images in the tablet layout.
Adjust the card layout so content remains the main focus on large screens

Visual presentation

To adjust the presentation of content-focused components, begin with spacing.

Allow components like listsLists are continuous, vertical indexes of text and images.More on lists, cards, and images to optimize space while filling the region of a screen that suits a device breakpoint’s ergonomic needs.

2 cards with optimized space: 1 narrow rectangle, 1 wide square.
Spacing adjusts for components such as cards, lists, and images
2 examples of the same card: 1 vertical with an image at the top, 1 horizontal with an image on the left.
Example of the same card with two different orientations and element positioning

Column-based layouts

In mobile layouts, components such as listsLists are continuous, vertical indexes of text and images.More on lists or cards are stretched to fit the full width of the screen without compromising visual quality or user experience. When designing for large screens with an expanded breakpointWindow widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop.More on expanded breakpoints, use multiple columns to display content.

Avoid extending UI elements across the screen when possible. On larger screens, rearrange groups of related cards into horizontal rows or carouselsCarousels show a collection of items that can be scrolled on and off the screen.More on carousels, to allow for better content organization.

3 related cards in a carousel.
When designing for large screens, use multiple columns to display content

Small screens

On smaller screens with the compact breakpointWindow widths smaller than 600dp, such as a phone in portrait orientation.More on compact breakpoints, consider swapping cards for listsLists are continuous, vertical indexes of text and images.More on lists, which can display images and text in a more compact form.

Make sure that controls, actions, and other component-specific elements are maintained.

Certain devices or user contexts require different components to meet platform expectations

Behavior ​

Expanding

Cards can use a container transform transition pattern to reveal additional content. Reserve this pattern for hero moments that are meant to be expressive.

A card expands to fill the full screen using a parent-child transition
Do Expand a card to reveal information
Don't Don’t scroll within a card to reveal information

Navigation

Cards can use a forward and backward transition pattern to navigate between screens at consecutive levels of hierarchy. This pattern has a simpler motion style compared to container transform, which makes it suitable for common navigation transitions.

Cards can use a forward and backward transition pattern to navigate between screens

Gestures

Swipe

A swipe gestureGestures are all the ways people interact with UI elements using touch.More on gestures can be performed on a single card at a time, anywhere on that card.

It can be used to:

  • Dismiss a card
  • Change the stateStates show the interaction status of a component or UI element.More on states of a card, such as flagging or archiving it
Do A card should only have one swipe action assigned to it
Don't Cards shouldn’t contain content that can be swiped, such as an image carousel or pagination. Also, swipe gestures shouldn’t cause portions of cards to detach upon swiping.

Pick up & move

The pick-up-and-move gestureGestures are all the ways people interact with UI elements using touch.More on gestures allows users to move and reorder cards in a collection.

Do When moving a card, increase its elevation
Don't Don’t let cards bump other elements out of the way. When a card is picked up, it appears in front of all elements, except app bars and navigation.

Scrolling

Card content that’s taller than the maximum card height is truncated and doesn’t scroll, but can be displayed by expanding the height of a card.

A card can expand beyond the maximum height of the screen, in which case the card scrolls within the screen.

Do On a mobile device, cards can expand to reveal more content, scrolling within the screen. Content within cards doesn’t scroll.
Don't On a mobile device, cards can't internally scroll, as it could cause two scroll bars to be displayed

Scrolling on desktop

On a desktop device, card content can expand and scroll within a card.

On a desktop, content can expand and scroll within a card
Pager
Previous pageCards: Specs
Next pageCards: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/cards/guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google