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.

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.


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.

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.

Do.

Don’t.
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.

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

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.

Icon left padding: 16dp
List item left padding: 72dp
List item right padding: 16dp

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.

Icon left padding: 16dp
List item left padding: 72dp
List right padding: 16dp

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.

Icon left padding: 16dp
List item left padding: 72dp
List right padding: 16dp

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.



Font: Roboto Regular 16sp
Height: 48dp
Left and right padding from screen edge: 16dp
Top padding: 8dp

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.



Font: Roboto Regular 16sp
Height: 48dp
Icon padding, left: 16dp
Text padding, left: 72dp
Top padding: 8dp

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.



Font: Roboto Regular 16sp
Height: 56dp
Left avatar padding: 16dp
Text padding, left: 72dp
Top padding: 8dp

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.



Font: Roboto Regular 16sp
Height: 56dp
Left avatar padding: 16dp
Right icon padding: 16dp
Text padding, left: 72dp
Top padding: 8dp

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.



Font: Roboto Regular 16sp
Height: 72dp
Left and right padding from screen edge: 16dp
Top padding: 8dp

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.



Font: Roboto Regular 16sp
Height: 72dp
Icon left padding: 16dp
Text left padding: 72dp
Padding above list: 8dp
Text right padding: 16dp

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.



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

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.



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

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.



Font: Roboto Regular 16sp
Tile height: 88dp
Text left padding: 16dp
Text right padding: 16dp
Padding above list: 8dp

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.



Font: Roboto Regular 16sp
Tile height: 88dp
Icon left padding: 16dp
Text left padding: 72dp
Text padding right: 16dp
Padding above list: 8dp

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.



Font: Roboto Regular 16sp
Tile height: 88dp
Padding above list: 8dp
Padding left of avatar: 16dp
Text left padding: 72dp
Text right padding: 16dp

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.



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

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