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

Lists ​

Lists are continuous, vertical indexes of text or images.

Interactive demo ​

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

Usage ​

Lists are a continuous group of text or images. They are composed of items containing primary and supplemental actions, which are represented by icons and text.


Image lists

Image lists display a collection of images in an organized grid.

Related article

Cards

Containing content & links on a single subject

Related article

Principles ​


List principle: logical

Logical

Lists should be sorted in logical ways that make content easy to scan, such as alphabetical, numerical, chronological, or by user preference.

List principle: actionable

Actionable

Lists present content in a way that makes it easy to identify a specific item in a collection and act on it.

List principle: consistent

Consistent

Lists should present icons, text, and actions in a consistent format.

Types ​


Single-line list items contain a maximum of one line of text
1. Single-line list
Single-line list items contain a maximum of one line of text.

2. Two-line list
Two-line list items contain a maximum of two lines of text.

3. Three-line list
Three-line list items contains a maximum of three lines of text.

Anatomy ​

Lists are optimized for reading comprehension. A list consists of a single continuous column of subdivisions called rows that contain items of content.

Diagram of list, row, list item content
1. List
2. Row
3. List item content

Content types ​

Content types can take different forms, depending on the needs of a list.

List items are comprised of three different content types
List items are comprised of three different content types:

1. Supporting visuals
2. Primary text
3. Metadata

A list control can display information and actions for list items.

Lists with controls contain three content types
Lists with controls contain three content types:

1. Supporting visuals
2. Primary text
3. List control

A list should be easily scannable, and any element of a list can be used to anchor and align list item content. Scannability is improved when elements (such as supporting visual and primary text) are placed in consistent locations across list items.

Content types: sample list
1. Sample list
2. Content placement in a row
3. Supporting visuals are aligned for easy scanning
4. Primary text is aligned for easy scanning

Visuals, dividers, and spacing ​

List structure can be organized using visuals, dividers, and spacing.

Do: improve scannability by anchoring supporting visuals, such as thumbnails, along the row's edge

Do

Improve scannability by anchoring supporting visuals, such as thumbnails, along the row's edge.
Caution: placing supporting visuals in the center of the row can make it difficult to see the relationship between primary

Caution

Placing supporting visuals in the center of the row can make it difficult to see the relationship between primary content and supporting content.

Do: place a divider between rows with lots of content, such as those with three-line lists

Do

Place a divider between rows with lots of content, such as those with three-line lists.
Caution: distinguish rows by maintaining sufficient space between list items

Caution

Distinguish rows by maintaining sufficient space between list items.

The primary action takes up the majority of space
The primary action takes up the majority of space.
1. Primary Action area
2. Secondary Action area
Clear hierarchy is created by aligning the most distinguishing content on the left
Clear hierarchy is created by aligning the most distinguishing content on the left, with the least distinguishing on the right.
1. More distinguishing content
2. Less distinguishing content

Dividers

A divider is a thin, lightweight rule that groups content in lists and page layouts.

Related article

Subheaders ​

Subheaders delineate sections of a list. They appear on list rows.

A subheader should be left-aligned with an avatar or icon in a list
1. Subheader
A subheader should be left-aligned with an avatar or icon in a list.

2. Subheader inset
If a floating action button is aligned with list avatars or icons, the subheader should be aligned with the text content.

Behavior ​

Transitions ​

Tapping a list item expands it across the entire screen using a container transform transition pattern.

To expand a list item, display a parent-child transition.

Navigation transitions

Navigational transitions are movements between states in an app, such as from a high-level view to a detailed view.

Related article

Container transform

For transitions between UI elements that include a container

Related article

Gestures ​

Swiping a list item (either left or right) can perform an action.

To archive a list item, swipe it.

Items can be dragged to reorder a list.

To reorder a list item, drag it.

Expand ​

A three-line list transition (on mobile) is displayed as a two-line list (on desktop).

Diagram of a three-line list on mobile, a two-line list on desktop
Scaled down to 50%
1. A three-line list on mobile
2. A two-line list on desktop

Transform ​

On a larger screen, a list may transform into an image list.

Diagram of a one-line list on mobile, an image list on desktop
1. A one-line list on mobile
2. An image list on desktop

Reveal additional content ​

Lists can also show more or less content as they scale up and down in size. For example, a list item can reveal more content when the component expands.

List items on larger screens (right) can display more information as the screen size transitions from small to medium
List items on larger screens (right) can display more information as the screen size transitions from small to medium breakpoints.

Scaling and adaptation ​

Line length ​

Avoid excessively long lines of text when expanding containers and text-heavy components within fluid layouts. This often means changing margins and typography properties as the container scales.

The ideal line length for text is typically between 40-60 characters, but large screen devices can accommodate up to 120 characters per line. Consider increasing the line height to improve readability if a line of text becomes close to 120 characters in length.

Adapt the width of the list container based on a line’s length, or by switching to a multi-column layout.

Do: adjust margins to create a more comfortable line length for reading

Do

Adjust margins to create a more comfortable line length for reading.

Don’t scale components without adjusting other affected areas of the screen, such as text length

Don't

Don’t scale components without adjusting other affected areas of the screen, such as text length. This can result in line lengths that make reading difficult.

Do: a multi-column layout can help break up content when needed

Do

A multi-column layout can help break up content when needed.

Component adaptation ​

Visual presentation is the most common method of adaptation, affecting the scale and placement of content and objects on a screen, as well as their relationships to each other.

For example, a text list on mobile can adjust its margins, vertical spacing, or density to better fit large screens like tablets.

Component swapping ​

Given the flexibility needed for lists and cards to support multiple types of content, use caution if swapping between the two on large screens. As screen sizes increase, there are new opportunities for text and image compositions; in large screens you can use more space for images and text.

Component swapping

Composition ​

Lists and views

On smaller screens, lists extend edge-to-edge. Users navigate between full-screen views, as seen in a photo app’s transition from a thumbnail list to full image view.

On small screens, users navigate between full-screen views
On small screens, users navigate between full-screen views.

Large screens can display primary and secondary content in the same view, such as a list adjacent to a detail view.

On larger screens, a list/detail view can be more appropriate
On larger screens, a list/detail view can be more appropriate.

Types ​

Single-line list ​


Single-line list: a text list
A text list.
A single-line list with icons and text
A single-line list with icons and text.

Scaled down to 50% on desktop, a single-line list with icons and text
Scaled down to 50% on desktop, a single-line list with icons and text.

Two-line list ​

In a two-line list, each row contains two lines of text maximum.

A two-line list, with an icon and meta icon
A two-line list, with an icon and meta icon.
A two-line list, with a thumbnail and meta text
A two-line list, with a thumbnail and meta text.

The amount of text can vary between different rows within the same list
The amount of text can vary between different rows within the same list.

Scaled down to 50% on desktop, a two-line list accompanied by an avatar and meta text
Scaled down to 50% on desktop, a two-line list accompanied by an avatar and meta text.

Three-line list ​


A three-line text with an avatar
A three-line text with an avatar.
A three-line text list, with a thumbnail and meta text
A three-line text list, with a thumbnail and meta text.

The amount of text can vary between rows within the same list
The amount of text can vary between rows within the same list.

On desktop, a three-line list accompanied by a large thumbnail and meta text
On desktop, a three-line list accompanied by a large thumbnail and meta text.

List controls ​

List controls display information and actions for list items.

Checkbox ​

A checkbox can either be a primary or secondary action.

This checkbox is the list item’s secondary action
1. Secondary action
This checkbox is the list item’s secondary action.

2. Primary action
This checkbox is both the list item’s primary action and state indicator.

Expand and collapse ​

Show and hide details of existing list items by expanding and collapsing list content vertically.

Tapping the list control expands the list
Tapping the list control expands the list.
An expanded list
An expanded list.

Switch


Tapping the list control expands the list
Tapping the list control expands the list.

Reorder


Usually appearing in edit mode, dragging lists items moves them to other locations within the list
Usually appearing in edit mode, dragging lists items moves them to other locations within the list. This reorder icon is the list item's secondary action.

Theming ​

Basil Material theme ​

This recipe app's lists have been customized using Material Theming. Areas of customization include color and typography.

Basil's customized list
Basil's customized list.

Basil

Basil is a recipe app that uses Material Design components and Material Theming to create an on-brand experience that is exciting and easy to explore.

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 ​

Basil's lists use custom color on four elements: the background, icon, item text, and quantity text.

Basil Material theme: color
ElementCategoryAttributeValue
SurfaceSurfaceColor
Opacity
#FFFBE6
100%
Item text, IconsPrimaryColor
Opacity
#356859
100%
Quantity textOn SurfaceColor
Opacity
#29302E
100%

Understanding typography

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

Related article

Typography ​

Basil's lists use custom typography for item and quantity text.

Basil Material theme: typography
ElementCategoryAttributeValue
Item textSubtitle 1Typeface
Font
Size
Case
Lekton
Bold
16
Title case
Quantity textCaptionTypeface
Font
Size
Case
Lekton
Regular
12
Sentence case

Crane Material theme ​

This travel app's lists have been customized using Material Theming. Areas of customization include color and typography.

Crane's customized list
Crane's customized list.

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

Typography ​

Crane's lists use custom typography for title and caption text.

Crane Material theme: typography
ElementCategoryAttributeValue
Title textSubtitle 1Typeface
Font
Size
Case
Raleway
Medium
16
Title case
Caption textCaptionTypeface
Font
Size
Case
Raleway
SemiBold
12
Title case

Specs ​

One line ​


One line on mobile spec

56565688

56565656

Two line ​


64647272727216162428161616321616161616168282020243220322032242024322024 x 2440 x 4040 x 40100 x 5624 x 2424 x 2424 x 24

88727272

Three line ​


161688888888888816161616161632162016161620282820282028202820161616236282024 x 2440 x 40100 x 5624 x 2440 x 40

The trailing padding (padding to the right of the image) in the example above and below is intended to be 16dp.


88888888

Collapsed & expanded ​


4848484872163224 x 24
Pager
Previous pageImage lists
Next pageMenus

Released under the Apache-2.0

Copyright © 2018-Present Google

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

Released under the Apache-2.0

Copyright © 2018-Present Google