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

Environment

Material properties

Elevation & shadows

What's new

Motion

Material motion

Duration & easing

Movement

Transforming material

Choreography

Creative customization

Style

Color

Icons

Imagery

Typography

Writing

Layout

Principles

Units & measurements

Metrics & keylines

Structure

Responsive UI

Split screen

Components

Bottom navigation

Bottom sheets

Buttons

Buttons: Floating Action Button

Cards

Chips

Data tables

Dialogs

Dividers

Expansion panels

Grid lists

Lists

Lists: Controls

Menus

Pickers

Progress & activity

Selection controls

Sliders

Snackbars & toasts

Steppers

Subheaders

Tabs

Text fields

Toolbars

Tooltips

Widgets

Patterns

Confirmation & acknowledgement

Data formats

Empty states

Errors

Fingerprint

Gestures

Help & feedback

Launch screens

Loading images

Navigation

Navigation drawer

Navigational transitions

Notifications

Offline states

Permissions

Scrolling techniques

Search

Selection

Settings

Swipe to refresh

Growth & communications

Introduction

Onboarding

Feature discovery

Gesture education

Usability

Accessibility

Bidirectionality

Platforms

Platform adaptation

Android

Resources

Color palettes

Devices

Layout templates

Roboto & Noto fonts

Sticker sheets & icons

Shadows

On this page

Lists ​

Lists present multiple line items vertically as a single continuous element.

Lists are made up of a continuous column of rows. Each row contains a tile. Primary actions fill the tile, and supplemental actions are represented by icons and text.

Lists are best suited for similar data types.

Actions

Vertical scrolling
Filtering and sorting


Gestures

Swipe
Drag and drop


Alternatives

Cards
Grid lists

Material Design vertical lists of multiple items

Usage ​

A list consists of a single continuous column of tessellated sub-divisions of equal width called rows that function as containers for tiles.

Tiles hold content, and can vary in height within a list.

Material Design list
List
Rows and tiles in Material Design lists
Row and tile

Lists are best suited to presenting a homogeneous data type or sets of data types, such as images and text. They are optimized for reading comprehension while differentiating either between similar data types, or qualities within a single data type.

List alternatives:

  • If more than three lines of text need to be shown in list tiles, use cards instead
  • If the primary distinguishing content consists of images, use a grid list

Density

When the mouse and keyboard are the primary input methods, measurements may be condensed to accommodate denser layouts.

Material Design typical list scanning pattern
Typical list scanning pattern

Behavior ​

Scrolling ​

Lists scroll only vertically.

Gestures ​

The swipe action of each tile should be consistent within lists.

Tiles may be moved between a list and drop target (similar to moving a file into a folder) and picked up and manually reordered within a list.

Filtering and sorting

List tiles can be sorted or filtered by date, file size, alphabetical order, or other parameters.

Material Design list: Alphabetical sorting for easier info access

Do.

Alphabetical sorting makes information easier to find.
Use logical sort order in Material Design list

Don’t.

Don’t display information in random order; if the UI doesn’t allow the user to sort a list, your app should use a logical sort order.

Content ​

Collections of list tiles present related content in a consistent format. Lists use hierarchy to prioritize a type or set of content, which helps users find the most important information. For example, in an email inbox app, an avatar and text snippet are emphasized over a time stamp.

List tiles may contain up to three lines of text, and text length may vary between tiles in the same list. To display more than three lines of text, use a card.

Align key content left for Material Design list
Place the most distinguishing content on the left of the tile and the least distinguishing content on the right.

Specifications:

  • The majority of space on a list tile should be dedicated to the primary action
  • Place the most distinguishing content towards the left of the tile
  • In tiles with multi-line content, place the most distinguishing content in the first line
  • Place supplemental actions on the right side
Material Design list: Primary action dominates tile space
The primary action takes up the majority of the space on the tile. The supplemental action goes on the right side of the tile.

Actions ​

Primary and supplemental actions (such as play, zoom in, delete, and select) may open a subsequent view, such as a card. They do not have a submenu or an action overflow menu.

Primary actions

  • Fill the entire tile and are not represented solely by an individual icon or text button
  • Are consistent for all tiles in a specific list, such as the primary action in a list of music to play songs

Supplemental actions

  • Are represented by icons, secondary text, etc
  • Have consistent functionality throughout a list, such as an icon that indicates if someone is online
  • Have a consistent location in a list’s tiles

Repeating actions

Avoid displaying a repeated supplemental action in tiles, such as a share action in every tile.

Toggles, such as stars or pins, are exceptions because they provide unique information about each individual tile.

Specs ​

In a single-line list, each tile contains a single line of text. The amount of text can vary between tiles within the same list.

Single-line list specs in Material Design
Single-line list specs
Icon left padding: 16dp
List item left padding: 72dp
List item right padding: 16dp
Single-line list example in Material Design
Example of a single-line list

In a two-line list, each tile contains a maximum of two lines of text. The amount of text can vary between tiles within the same list.

Two-line list specs in Material Design
Two-line list specs
Icon left padding: 16dp
List item left padding: 72dp
List right padding: 16dp
Example of a two-line list in Material Design
Example of a two-line list

In a three-line list, each tile contains a maximum of three lines of text.

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

Three-line list specs in Material Design
Three-line list specs

Icon left padding: 16dp
List item left padding: 72dp
List right padding: 16dp
Three-line list example in Material Design
Example of a three-line list

Single-line list

Text only

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Bottom padding is measured from the baseline.

Single-line list in Material Design
Single-line list
Single-line list example in Material Design
Example of a single-line list
Single-line list specs in Material Design
Single-line list specs

Font: Roboto Regular 16sp
Height: 48dp
Left and right padding from screen edge: 16dp
Top padding: 8dp
Material Design dense single-line list specs
Dense single-line list specs

Font: Roboto Regular 13sp
Height: 40dp
Left and right padding from screen edge: 16dp
Top padding: 4dp

Icon with text

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Bottom padding is measured from the baseline.

Single-line list with icon in Material Design
Single-line list with icon
Material Design single-line list with icon example
Example of a single-line list with icon
Material Design single-line list with icon specs
Single-line list with icon specs

Font: Roboto Regular 16sp
Height: 48dp
Icon padding, left: 16dp
Text padding, left: 72dp
Top padding: 8dp
Material Design dense single-line list with icons
Dense single-line list with icon specs

Font: Roboto Regular 13sp
Height: 40dp
Icon padding, left: 16dp
Text padding, left: 72dp
Top padding: 4dp

Avatar with text

Bottom padding is measured from the baseline.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Single-line item with avatar in Material Design
Single-line item with avatar
Single-line item with avatar in Material Design
Example of a single-line item with avatar
Material Design single-line item with avatar
Single-line item with avatar specs

Font: Roboto Regular 16sp
Height: 56dp
Left avatar padding: 16dp
Text padding, left: 72dp
Top padding: 8dp
Dense single-line item with avatar in Material Design
Dense single-line item with avatar specs

Font: Roboto Regular 13sp
Height: 48dp
Left avatar padding: 16dp
Text padding, left: 72dp
Top padding: 4dp

Avatar with text and icon

Right icon padding: 16dp

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Bottom padding is measured from the baseline.

Single-line item with avatar and icon in Material Design
Single-line item with avatar and icon
Material Design single-line item with avatar and icon
Example of a single-line item with avatar and icon
Material Design single-line item with avatar and icon
Single-line item with avatar and icon specs

Font: Roboto Regular 16sp
Height: 56dp
Left avatar padding: 16dp
Right icon padding: 16dp
Text padding, left: 72dp
Top padding: 8dp
Material Design dense item with avatar and icon specs
Dense single-line item with avatar and icon specs

Font: Roboto Regular 13sp
Height: 48dp
Left avatar padding: 16dp
Right icon padding: 16dp
Text padding, left: 72dp
Top padding: 4dp

Two-line list

Text only

Primary text font: Roboto Regular 16sp
Secondary text font: Roboto Regular 14sp
Tile height: 72dp
Text padding, left: 16dp
Text padding, top and bottom: 20dp

Bottom padding is measured from the baseline.

Add 8dp of padding at the top and bottom of a list. One exception is at the top of a list with a subheader, because subheaders contain their own padding.

Material Design two-line list layout
Two-line list
Two-line list example in Material Design
Example of a two-line list
Two-line list specs in Material Design
Two-line list specs:

Font: Roboto Regular 16sp
Height: 72dp
Left and right padding from screen edge: 16dp
Top padding: 8dp
Material Design dense two-line list specs
Dense two-line list specs:

Font: Roboto Regular 13sp
Height: 60dp
Left and right padding from screen edge: 16dp
Top padding: 4dp

Icon with text

Primary text font: Roboto Regular 16sp
Secondary text font: Roboto Regular 14sp
Tile height: 72dp
Left icon padding: 16dp
Text padding, left: 72dp
Text padding, top and bottom: 20dp
Bottom padding is measured from the baseline.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Two-line list with icon in Material Design
Two-line list with icon
Material Design two-line list with icon example
Example of a two-line list with icon
Material Design two-line list with icon specs
Two-line list with icon specs:

Font: Roboto Regular 16sp
Height: 72dp
Icon left padding: 16dp
Text left padding: 72dp
Padding above list: 8dp
Text right padding: 16dp
Material Design dense two-line list with icon specs
Dense two-line list with icon specs:

Font: Roboto Regular 13sp
Tile height: 60dp
Icon left padding: 16dp
Text left padding: 72dp
Padding above list: 4dp
Text right padding: 16dp

Avatar with text

Primary text font: Roboto Regular 16sp
Secondary text font: Roboto Regular 14sp
Tile height: 72dp
Left avatar padding: 16dp
Text padding, left: 72dp
Text padding, top and bottom: 20dp

Bottom padding is measured from the baseline.

Center-align icon with text area.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Two-line list with avatar in Material Design
Two-line list with avatar
Two-line list with avatar in Material Design
Example of a two-line list with avatar
Two-line list with avatar specs in Material Design
Two-line list with avatar specs:

Font: Roboto Regular 16sp
Tile height: 72dp
Icon left padding: 16dp
Text left padding: 72dp
Padding above list: 8dp
Text right padding: 16dp
Dense two-line list with avatar specs, Material Design
Dense two-line list with avatar specs:

Font: Roboto Regular 13sp
Tile height: 60dp
Icon left padding: 16dp
Text left padding: 72dp
Padding above list: 4dp
Text right padding: 16dp

Avatar with text and icon

Primary text font: Roboto Regular 16sp
Secondary text font: Roboto Regular 14sp
Tile height: 72dp
Left avatar padding: 16dp
Text padding, left: 72dp

Right icon padding: 16dp

Bottom padding is measured from the baseline.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Material Design list with avatar with text and icon
Avatar with text and icon
List with avatar, text and icon in Material Design
Example of an avatar with text and icon
Material Design list with avatar, text and icon specs
Avatar with text and icon

Font: Roboto Regular 16sp
Tile height: 72dp
Icon left padding: 16dp
Text left padding: 72dp
Padding above list: 8dp
Text right padding: 16dp
Material Design dense list with avatar, text and icon specs
Dense avatar with text and icon

Font: Roboto Regular 13sp
Tile height: 60dp
Icon left padding: 16dp
Text left padding: 72dp
Padding above list: 4dp
Text right padding: 16dp

Three-line list

Text only

Primary text font:Roboto Regular 16sp

Secondary text font: Roboto Regular 14sp
Tile height: 88dp
Text padding, left: 16dp
Text padding, top: 16dp
Text padding, bottom: 20dp

Bottom padding is measured from the baseline.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Material Design three-line list
Three-line list
Material Design example of a three-line list
Example of a three-line list
Material Design three-line list specs
Three-line list specs:

Font: Roboto Regular 16sp
Tile height: 88dp
Text left padding: 16dp
Text right padding: 16dp
Padding above list: 8dp
Material Design dense three-line list specs
Dense three-line list specs:

Font: Roboto Regular 13sp
Tile height: 76dp
Text left padding: 16dp
Text right padding: 16dp
Padding above list: 4dp

Icon with text

Primary text font: Roboto Regular 16sp
Secondary text font: Roboto Regular 14sp
Tile height: 88dp
Left icon padding: 16dp
Text left padding: 72dp
Text padding, top: 16dp
Text padding, bottom: 20dp

Bottom padding is measured from the baseline.

Top-align icon with primary text.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Material Design three-line list with icon
Three-line list with icon
Material Design example of a three-line list with icon
Example of a three-line list with icon
Material Design three-line list with icon specs
Three-line list with icon specs:

Font: Roboto Regular 16sp
Tile height: 88dp
Icon left padding: 16dp
Text left padding: 72dp
Text padding right: 16dp
Padding above list: 8dp
Material Design dense three-line list with icon specs
Dense three-line list with icon specs:

Font: Roboto Regular 13sp
Tile height: 76dp
Icon left padding: 16dp
Text left padding: 72dp
Text padding right: 16dp
Padding above list: 4dp

Avatar with text

Primary text font: Roboto Regular 16sp
Secondary text font: Roboto Regular 14sp
Tile height: 88dp
Left avatar padding: 16dp
Left text padding: 72dp
Text padding, top: 16dp
Text padding, bottom: 20dp

Bottom padding is measured from the baseline.

Top-align avatar with primary text.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Material Design three-line list with avatar
Three-line list with avatar
Material Design example of a three-line list with avatar
Example of a three-line list with avatar
Material Design three-line list with avatar specs
Three-line list with avatar specs:

Font: Roboto Regular 16sp
Tile height: 88dp
Padding above list: 8dp
Padding left of avatar: 16dp
Text left padding: 72dp
Text right padding: 16dp
Material Design dense three-line list with avatar specs
Dense three-line list with avatar specs:

Font: Roboto Regular 13sp
Tile height: 76dp
Padding above list: 4dp
Padding left of avatar: 16dp
Text left padding: 72dp
Text right padding: 16dp

Avatar with text and icon

Primary text font: Roboto Regular 16sp
Secondary text font: Roboto Regular 14sp
Tile height: 88dp
Left avatar padding: 16dp
Text left padding: 72dp
Text padding, top: 16dp
Text padding, bottom: 20dp

Right icon padding: 16dp

Bottom padding is measured from the baseline.

Top-align avatar and icon with primary text.

Add 8dp of padding at the top and bottom of a list, except for lists with subheaders, which have their own padding.

Material Design three-line list with avatar and icon
Three-line list with avatar and icon
Material Design example of a three-line list with avatar and icon
Example of a three-line list with avatar and icon
Material Design three-line list with avatar and icon specs
Three-line list with avatar and icon specs:

Font: Roboto Regular 16sp
Tile height: 88dp
Left avatar padding: 16dp
Text left padding: 72dp
Padding above list: 8dp
Right and left padding by the icon: 16dp
Material Design dense three-line list with avatar and icon specs
Dense three-line list with avatar and icon specs:

Font: Roboto Regular 13sp
Tile height: 76dp
Left avatar padding: 16dp
Text left padding: 72dp
Padding above list: 4dp
Right and left padding by the icon: 16dp
Pager
Previous pageGrid lists
Next pageLists: Controls

Released under the Apache-2.0

Copyright © 2014-Present Google

https://m1.material.io/components/lists.html

Released under the Apache-2.0

Copyright © 2014-Present Google