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

Lists: Specs ​

Lists are continuous, vertical indexes of text and images

Variants ​

Expressive lists ​

Use the expressive list variant for more flexible styling, highlighted selection states, and customizable slots.


2 expressive lists: a photos list on a tablet, and a song list on mobile.
An expressive list has a segmented style and round corners

Baseline lists ​


BaselineBaseline variants are the original M3 component designs. They may not have the latest features introduced in M3 Expressive, like updated motion, shapes, type, and styles.More on M3 Expressive lists are still available to use, but don’t have the latest visual style, selection treatment, and slot functionality.

On web, expressive lists are built on top of baseline lists.

See baseline list specs


3 baseline list items with square corners.
Baseline list items have square corners and standard colors

VariantsM3M3 Expressive
Lists (expressive)--Available
Lists (baseline)AvailableNot recommended.
Use expressive lists instead.

Configurations ​

Styles ​

The standard and segmented styles are a visual choice, and don’t affect a list’s behavior.

A standard list and segmented list in dark mode.
  1. Standard
  2. Segmented

List selection ​

A list can have only one selection mode at a time. For example, a single-action list can change to a multi-select list, but can’t be both at once.

A single-action list with 4 items and no additional actions.
In a single-action list, each item is a single tappable area
A list with 4 items. Each item has 2 trailing icons for additional actions.
Multi-action list items include a primary action, and one or more secondary actions
A list with 1 item selected.
A single-select list
A list with 2 items selected.
A multi-select list

List interactions ​

Lists can:

  • Expand and collapse
  • Swipe to reveal*

More on list interaction accessibility

A list can expand to include multiple items
A list item is swiped, and reveals 3 more actions.
A list item can be swiped to reveal more actions
CategoryConfigurationM3M3 Expressive
StylesStandardAvailableAvailable
Segmented--Available
Selection modesSingle-action, multi-action, single-select, multi-selectAvailableAvailable
InteractionsExpand, swipe\*AvailableAvailable

* Swipe-to-reveal interactions are only available on Android Views

Tokens & specs ​

Use the table's menu to select a token set. The common set combines baseline tokens with new expressive shapes and sizes. The expand set has tokens for the expand interaction. Learn about design tokens

List - Common ​

Theme
Contrast

List - Expand ​

Theme
Contrast

Anatomy ​

Diagram with 10 elements that can be included in lists.

Container and label text are required. All other elements are optional:

  1. Container
  2. Overline
  3. Label text
  4. Trailing text
  5. Supporting text
  6. Trailing icon
  7. Divider
  8. Leading avatar
  9. Leading icon
  10. Leading media - image or video

Flexibility & slots

The M3 Design Kit includes lists with custom slots for designing flexible item layouts. Think of a custom list as a container with three different slots: leading, content, and trailing. Each slot can hold a different element.

Slot accessibility

Slots are not accessible by default. Consider the following:

  • Elements must follow the rules, structure, and interaction patterns for lists
  • Use standard list item padding
  • Target size must be at least 48x48dp
  • Don't add interactive elements that make the list item difficult to navigate, especially for people using screen readers

More on required accessibility guidelines

A diagram with leading, content, and trailing slots.
Caution Reserve the use of slots for use cases that maintain the list’s accessibility and functionality
  1. Leading slot
  2. Content slot
  3. Trailing slot

WARNING

Slots require custom code implementation that you must create and maintain

The leading and trailing slot positions must be a smaller width than the content section.

1. Leading slots can contain:

  • Visual elements: Avatar, icon, image, or video thumbnail
  • SelectionSelection lets users choose specific items to act on.More on selection controls: Checkbox, radio button, or switch
  • Customizations: Badge or larger image

2. Content slots must be the largest-width slot and can contain:

  • Default content: Label text, supporting text
  • Optional add-ons: Badge, icon, in-line label, or more text elements
  • Avoid long lines of text to preserve readability

3. Trailing slots can contain:

  • Action elements or text: Icon, icon button, or trailing text
  • Selection controls: Checkbox, radio button, or switch
Slot diagram showing slot placement in the middle of the list.
The content slot must be the largest section, placed in the middle of the list item

Selection lists

For selection lists, use only one selection interaction per list item.

A selected list item with a checkmark in the leading slot.
Do Use only one selection interaction per list item
A selected list item with both a checkmark in the leading slot and a bookmark in the trailing slot.
Don't Don't use multiple selection interactions in one item

Color ​

Color values are implemented through design 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. Learn more about design tokens

10 list element color roles in light mode and dark mode.

List color roles used for light and dark themes:

  1. Surface
  2. On surface variant
  3. On surface
  4. On surface variant
  5. On surface variant
  6. On surface variant
  7. Outline variant
  8. Primary container
  9. On primary container
  10. On surface variant

States ​

States are visual representations used to communicate the status of a component or an interactive element. Learn more about interaction states

More on list focus

Default list items ​


6 default list states in light and dark mode.
  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed
  6. Dragged

Selected list items ​


6 selected list states in light and dark mode.
  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed
  6. Dragged

Measurements ​

Size and padding measurements for list items.
List item alignment, padding, and size measurements. The icon button height is dynamic, and automatically adjusts to fill the list item height.

Shape morphing

When a list item is selected, the corner shape changes to highlight the active item:

  • Unselected corner radius: 4dp inner, 16dp outer
  • Selected corner radius: 16dp
A 3-item list. The middle item is unselected, with a 4dp corner radius.
Unselected list items have a 4dp inner corner radius, and 16dp outer corner radius
A 3-item list. The middle item is selected, with a 16dp corner radius.
Selected list items have a 16dp corner radius all around

List (baseline) ​

The baselineBaseline variants are the original M3 component designs. They may not have the latest features introduced in M3 Expressive, like updated motion, shapes, type, and styles.More on M3 Expressive list variant is available and continues to work in existing products. However, the expressive list variant is recommended for new designs.

Tokens & specs ​

Baseline list tokensDesign tokens are the building blocks of all UI elements. The same tokens are used in designs, tools, and code.More on tokens are in the common token set.

TIP

This set also includes several expressive tokens.

Theme
Contrast

Color ​

Color values are implemented through design 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. Learn more about design tokens

9 baseline list element color roles in light and dark mode.

List color roles used for light and dark themes:

  1. Surface
  2. On surface
  3. On surface variant
  4. On surface variant
  5. On surface variant
  6. Outline variant
  7. Primary container
  8. On primary container
  9. On surface variant

States ​

States are visual representations used to communicate the status of a component or interactive element.

6 baseline list states in light and dark mode.
  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed
  6. Dragged

Layout ​

One-line lists ​


Alignment, padding, and size specifications for baseline list items with 1 line of text.
Baseline one-line list alignment, padding, and size measurements

Measurements for a 3-item list with 1 line each.
Baseline list item measurements and padding

Two-line lists ​


Alignment, padding, and size specifications for baseline list items with 2 lines of text.
Baseline two-line list alignment, padding, and size measurements

Measurements for a 3-item list with 2 lines each.
Baseline list item measurements and padding

Three-line lists ​


Alignment, padding, and size specifications for baseline list items with 3 lines of text.
Baseline three-line list alignment, padding, and size measurements

Measurements for a 3-item list with 3 lines each.
Baseline list item measurements and padding

AttributeValue
Label alignmentCenter
Label alignment when height is 88dp or tallerTop
Label left padding16dp
Leading element alignment (vertical)Center
Leading element alignment (vertical) when height is 88dp or tallerTop
Leading element left padding16dp
Leading icon alignment (vertical)Top
Leading icon top padding8dp
Leading icon top padding when height is 88dp or taller12dp
Trailing element alignment (vertical)Center
Trailing element alignment (vertical) when height is 88dp or tallerTop
Trailing element left padding16dp
Trailing element right padding24dp
Padding above/below divider0dp
Targets48dp
Divider full-width100%
Divider inset left padding16dp
Divider inset right padding24dp

Configurations ​

Leading avatar ​


1, 2, and 3-line list items with and without a leading avatar and trailing checkbox, in dark mode.
  1. With leading avatar
  2. With leading avatar and trailing checkbox

Leading image or thumbnail ​


1, 2, and 3-line list items with and without a leading image and trailing checkbox, in dark mode.
  1. With leading image
  2. With leading image and trailing checkbox

Leading video ​


1, 2, and 3-line list items with and without a leading video and trailing checkbox, in dark mode.
  1. With leading video
  2. With leading video and trailing checkbox

Leading icon ​


1, 2, and 3-line list items with and without a leading icon and trailing checkbox, in dark mode.
  1. With leading icon
  2. With leading icon and trailing checkbox

Text-only ​


1, 2, and 3-line text only list items with and without a trailing checkbox, in dark mode.
  1. With text only
  2. With text and trailing checkbox

Leading checkbox ​


1, 2, and 3-line list items with and without a leading checkbox and trailing text, in dark mode.
  1. With leading checkbox
  2. With leading checkbox and trailing text

Leading radio button ​


1, 2, and 3-line list items with and without a leading radio button and trailing text, in dark mode.
  1. With leading radio button
  2. With leading radio button and trailing text

Trailing switch ​


1, 2, and 3-line list items with and without a leading icon and trailing switch, in dark mode.
  1. With trailing switch
  2. With leading icon and trailing switch
Pager
Previous pageLists: Overview
Next pageLists: Guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/lists/specs

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google