---
title: CPListImageRowItem
framework: carplay
role: symbol
role_heading: Class
path: carplay/cplistimagerowitem
---

# CPListImageRowItem

A list template row that displays a series of images.

## Declaration

```swift
@MainActor class CPListImageRowItem
```

## Overview

Overview Use CPListImageRowItem to display a series of images as a row in a list template. At runtime, use CPMaximumNumberOfGridImages to determine the maximum number of images that the row displays. CarPlay may display fewer images, depending on the width of the vehicle’s primary screen. Provide images that are display-ready, and include light and dark variants of each. See init(text:images:) for more information. You assign a handler to the list item that CarPlay executes when the user selects the item. You can assign a second handler, listImageRowHandler, which CarPlay calls when the user selects an individual image. CarPlay doesn’t support custom list item types. Instead, use the userInfo property to attach a value to the list item that provides additional context, such as specifying  a model object that corresponds to the item.

## Topics

### Creating a List Image Row Item

- [init(text:images:)](carplay/cplistimagerowitem/init(text:images:).md)
- [init(text:images:imageTitles:)](carplay/cplistimagerowitem/init(text:images:imagetitles:).md)

### Managing Content

- [text](carplay/cplistimagerowitem/text.md)
- [gridImages](carplay/cplistimagerowitem/gridimages.md)
- [update(_:)](carplay/cplistimagerowitem/update(_:).md)
- [maximumImageSize](carplay/cplistimagerowitem/maximumimagesize.md)
- [CPMaximumNumberOfGridImages](carplay/cpmaximumnumberofgridimages.md)

### Managing Selection

- [listImageRowHandler](carplay/cplistimagerowitem/listimagerowhandler.md)
- [handler](carplay/cplistimagerowitem/handler.md)

### Managing Supplementary Information

- [userInfo](carplay/cplistimagerowitem/userinfo.md)

### Enabling Items

- [isEnabled](carplay/cplistimagerowitem/isenabled.md)

### Initializers

- [init(text:cardElements:allowsMultipleLines:)](carplay/cplistimagerowitem/init(text:cardelements:allowsmultiplelines:).md)
- [init(text:condensedElements:allowsMultipleLines:)](carplay/cplistimagerowitem/init(text:condensedelements:allowsmultiplelines:).md)
- [init(text:elements:allowsMultipleLines:)](carplay/cplistimagerowitem/init(text:elements:allowsmultiplelines:).md)
- [init(text:gridElements:allowsMultipleLines:)](carplay/cplistimagerowitem/init(text:gridelements:allowsmultiplelines:).md)
- [init(text:imageGridElements:allowsMultipleLines:)](carplay/cplistimagerowitem/init(text:imagegridelements:allowsmultiplelines:).md)

### Instance Properties

- [allowsMultipleLines](carplay/cplistimagerowitem/allowsmultiplelines.md)
- [elements](carplay/cplistimagerowitem/elements.md)
- [imageTitles](carplay/cplistimagerowitem/imagetitles.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CPListTemplateItem](carplay/cplisttemplateitem.md)
- [CPSelectableListItem](carplay/cpselectablelistitem.md)
- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [Sendable](swift/sendable.md)

## See Also

### Creating a Section

- [init(items:header:headerSubtitle:headerImage:headerButton:sectionIndexTitle:)](carplay/cplistsection/init(items:header:headersubtitle:headerimage:headerbutton:sectionindextitle:).md)
- [CPListTemplateItem](carplay/cplisttemplateitem.md)
- [CPSelectableListItem](carplay/cpselectablelistitem.md)
- [CPListItem](carplay/cplistitem.md)
- [CPMessageListItem](carplay/cpmessagelistitem.md)