Rows are customizable components used to build various list types, like lists
with data or images. They are supported by templates and can display a small
amount of text along with other elements.

## Row variants

You can customize rows by adding images, icons, buttons, and more to unlock more
functionality for drivers. These examples show each of the available options.

**Title**: Mandatory. Up to 2 lines, where the second line either wraps or comes
after line break.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-1.png)

**Secondary text**: Optional. Up to 2 lines with customizable text color.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-2.png)

**Inline icon**: Optional. In either primary or secondary text.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-3.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-4.png)

**Numeric decoration**: Optional. Typically used to indicate a quantity of
unseen content, such as unread messages.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-5.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-6.png)

**Image**: Optional
![](https://developer.android.com/static/images/design/ui/cars/components/rows-7.png)

**Actions**: When used in certain templates, rows can have up to two action
buttons.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-8.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-9.png)

**Browsable**: When a row is marked as browsable, the system will provide an
icon that indicates this. Browsable rows must also be clickable (see below) and
cannot contain actions.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-10.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-11.png)

### How rows behave

- **Clickable**: Optional. The row can be marked
- **Enabled**: By default, all rows are treated as enabled. You can mark a row as disabled to make it unavailable and
- **Indexable**: By default, all rows are indexed by their title text for alphabetical sorting when used in a template that supports that functionality. You can mark a row

## Template support

The following templates support rows:

- [Sectioned Item template](https://developer.android.com/design/ui/cars/guides/templates/sectioned-item-template)
- [List](https://developer.android.com/design/ui/cars/guides/templates/list-template)
- [Place List (map)](https://developer.android.com/design/ui/cars/guides/templates/place-list-map-template)
- [Search](https://developer.android.com/design/ui/cars/guides/templates/search-template)
- [Pane template](https://developer.android.com/design/ui/cars/guides/templates/pane-template) with no line dividers in the Pane template because its rows are not actionable

## Row items

In addition to primary and secondary text, and an image or icon, rows on the
List template can also include any of the following:

**Toggle switch**: Optional
![](https://developer.android.com/static/images/design/ui/cars/components/rows-12.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-13.png)

**Radio button**: Optional. Used only in selectable lists, which must have radio
buttons on all rows.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-14.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-15.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-16.png) ![](https://developer.android.com/static/images/design/ui/cars/components/rows-17.png)

**Longer secondary text**: If secondary text is longer than 2 lines, it will be
truncated while driving. The full text will be visible only when parked.
![](https://developer.android.com/static/images/design/ui/cars/components/rows-18.png)

### Guidance

A row with a toggle switch can't contain a radio button, and the other way
round. Also, carats are not used on lists with either toggle switches or radio
buttons. However, a row with either of these options can also contain an image
or icon and wrapping text.

### Rows when parked

When parked, you can include longer text in rows, as shown in the following
examples.

### Resources

|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Type          | Link                                                                                                                                                                         |
| API reference | ` `[Row](https://developer.android.com/reference/androidx/car/app/model/Row)`, `[Row.Builder](https://developer.android.com/reference/androidx/car/app/model/Row.Builder)` ` |