<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CarPlay",
  "identifier" : "/documentation/CarPlay/CPListImageRowItem",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "CarPlay"
    ],
    "preciseIdentifier" : "c:objc(cs)CPListImageRowItem"
  },
  "title" : "CPListImageRowItem"
}
-->

# CPListImageRowItem

A list template row that displays a series of images.

```
@MainActor class CPListImageRowItem
```

## Overview

Use `CPListImageRowItem` to display a series of images as a row in a list template. At runtime, use [`CPMaximumNumberOfGridImages`](/documentation/CarPlay/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:)`](/documentation/CarPlay/CPListImageRowItem/init(text:images:)) for more information.

You assign a [`handler`](/documentation/CarPlay/CPListImageRowItem/handler) to the list item that CarPlay executes when the user selects the item. You can assign a second handler, [`listImageRowHandler`](/documentation/CarPlay/CPListImageRowItem/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:)`](/documentation/CarPlay/CPListImageRowItem/init(text:images:))

Creates a list item that displays a row of images.

[`init(text:images:imageTitles:)`](/documentation/CarPlay/CPListImageRowItem/init(text:images:imageTitles:))

Creates a list item that displays a row of images with a title below each image.

### Managing Content

[`text`](/documentation/CarPlay/CPListImageRowItem/text)

The list item’s primary text.

[`gridImages`](/documentation/CarPlay/CPListImageRowItem/gridImages)

The images that appear in the list item’s image row.

[`update(_:)`](/documentation/CarPlay/CPListImageRowItem/update(_:))

Adds, removes, reorders, or updates the images in the list item’s image row.

[`maximumImageSize`](/documentation/CarPlay/CPListImageRowItem/maximumImageSize)

The maximum size of an image that an image row can display.

[`CPMaximumNumberOfGridImages`](/documentation/CarPlay/CPMaximumNumberOfGridImages)

The maximum number of images that an image row can contain.

### Managing Selection

[`listImageRowHandler`](/documentation/CarPlay/CPListImageRowItem/listImageRowHandler)

An optional closure that CarPlay invokes when the user selects an image.

[`handler`](/documentation/CarPlay/CPListImageRowItem/handler)

An optional closure that CarPlay invokes when the user selects the list item.

### Managing Supplementary Information

[`userInfo`](/documentation/CarPlay/CPListImageRowItem/userInfo)

An opaque value for the list item.

### Enabling Items

[`isEnabled`](/documentation/CarPlay/CPListImageRowItem/isEnabled)

A Boolean value that indicates if the item is enabled.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)