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.

Baseline lists
Baseline 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.

| Variants | M3 | M3 Expressive |
|---|---|---|
| Lists (expressive) | -- | Available |
| Lists (baseline) | Available | Not recommended. Use expressive lists instead. |
Configurations
Styles
The standard and segmented styles are a visual choice, and don’t affect a list’s behavior.

- Standard
- 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.




List interactions
Lists can:
More on list interaction accessibility

| Category | Configuration | M3 | M3 Expressive |
|---|---|---|---|
| Styles | Standard | Available | Available |
| Segmented | -- | Available | |
| Selection modes | Single-action, multi-action, single-select, multi-select | Available | Available |
| Interactions | Expand, swipe\* | Available | Available |
* 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
List - Expand
Anatomy

Container and label text are required. All other elements are optional:
- Container
- Overline
- Label text
- Trailing text
- Supporting text
- Trailing icon
- Divider
- Leading avatar
- Leading icon
- 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

- Leading slot
- Content slot
- 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
- 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

Selection lists
For selection lists, use only one selection interaction per list 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

List color roles used for light and dark themes:
- Surface
- On surface variant
- On surface
- On surface variant
- On surface variant
- On surface variant
- Outline variant
- Primary container
- On primary container
- 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
Default list items

- Enabled
- Disabled
- Hovered
- Focused
- Pressed
- Dragged
Selected list items

- Enabled
- Disabled
- Hovered
- Focused
- Pressed
- Dragged
Measurements

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


List (baseline)
The baseline 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 tokens are in the common token set.
TIP
This set also includes several expressive tokens.
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

List color roles used for light and dark themes:
- Surface
- On surface
- On surface variant
- On surface variant
- On surface variant
- Outline variant
- Primary container
- On primary container
- On surface variant
States
States are visual representations used to communicate the status of a component or interactive element.

- Enabled
- Disabled
- Hovered
- Focused
- Pressed
- Dragged
Layout
One-line lists


Two-line lists


Three-line lists


| Attribute | Value |
|---|---|
| Label alignment | Center |
| Label alignment when height is 88dp or taller | Top |
| Label left padding | 16dp |
| Leading element alignment (vertical) | Center |
| Leading element alignment (vertical) when height is 88dp or taller | Top |
| Leading element left padding | 16dp |
| Leading icon alignment (vertical) | Top |
| Leading icon top padding | 8dp |
| Leading icon top padding when height is 88dp or taller | 12dp |
| Trailing element alignment (vertical) | Center |
| Trailing element alignment (vertical) when height is 88dp or taller | Top |
| Trailing element left padding | 16dp |
| Trailing element right padding | 24dp |
| Padding above/below divider | 0dp |
| Targets | 48dp |
| Divider full-width | 100% |
| Divider inset left padding | 16dp |
| Divider inset right padding | 24dp |
Configurations
Leading avatar

- With leading avatar
- With leading avatar and trailing checkbox
Leading image or thumbnail

- With leading image
- With leading image and trailing checkbox
Leading video

- With leading video
- With leading video and trailing checkbox
Leading icon

- With leading icon
- With leading icon and trailing checkbox
Text-only

- With text only
- With text and trailing checkbox
Leading checkbox

- With leading checkbox
- With leading checkbox and trailing text
Leading radio button

- With leading radio button
- With leading radio button and trailing text
Trailing switch

- With trailing switch
- With leading icon and trailing switch