<!--
{
  "availability" : [
    "iOS: 17.4.0 - 26.0.0",
    "iPadOS: 17.4.0 - 26.0.0",
    "macCatalyst: 17.4.0 - 26.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "CarPlay",
  "identifier" : "/documentation/CarPlay/CPListImageRowItem/init(text:images:imageTitles:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "CarPlay"
    ],
    "preciseIdentifier" : "c:objc(cs)CPListImageRowItem(im)initWithText:images:imageTitles:"
  },
  "title" : "init(text:images:imageTitles:)"
}
-->

# init(text:images:imageTitles:)

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

```
init(text: String, images: [UIImage], imageTitles: [String])
```

## Parameters

`text`

The list item’s primary text.

`images`

An array of images to display in the list item’s image row.

`imageTitles`

An array of strings that represent the image titles.

## Discussion

Provide images that are display-ready. If necessary, provide light and dark variants of each image using an asset catalog, or use instances of <doc://com.apple.documentation/documentation/UIKit/UIImageAsset> and register an image for each interface style.

To properly size your images, use the display scale of the vehicle’s primary screen, which you access from your interface controller’s [`carTraitCollection`](/documentation/CarPlay/CPInterfaceController/carTraitCollection) property. At runtime, use [`maximumImageSize`](/documentation/CarPlay/CPListImageRowItem/maximumImageSize) to determine the maximum size that CarPlay allows for an image, and [`CPMaximumNumberOfGridImages`](/documentation/CarPlay/CPMaximumNumberOfGridImages) to establish the total number of images that an image row can display. The list item may display fewer images, depending on the width of the vehicle’s primary screen.

Carplay uses `UIImageAsset` to combine multiple <doc://com.apple.documentation/documentation/UIKit/UIImage> objects with different trait collections into a single `UIImage` and the framework resizes images, if necessary. CarPlay doesn’t support animated images, if you provide animated images, the framework uses only the first image in each animation sequence.

The number of titles in the `imageTitles` list needs to be equal to the number of images in the `images`.

---

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)