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

# CPMessageListItemLeadingConfiguration

An object that describes the appearance of a message list item’s leading region.

```
class CPMessageListItemLeadingConfiguration
```

## Overview

Use a leading configuration to describe the visual elements that a message list item’s leading region contains. The region can show a [`CPMessageLeadingItem`](/documentation/CarPlay/CPMessageLeadingItem), an image, and an unread indicator.

Configurations are immutable. To modify the list item’s leading configuration, update its [`leadingConfiguration`](/documentation/CarPlay/CPMessageListItem/leadingConfiguration) property with a new configuration. CarPlay detects the change and redraws the message list item.

## Topics

### Creating a Configuration

[`init(leadingItem: CPMessageLeadingItem, leadingImage: UIImage?, unread: Bool)`](/documentation/CarPlay/CPMessageListItemLeadingConfiguration/init(leadingItem:leadingImage:unread:))

Creates a leading configuration that contains an item and an image.

[`let CPMaximumMessageItemImageSize: CGSize`](/documentation/CarPlay/CPMaximumMessageItemImageSize)

The maximum size of a message list item’s image.

### Getting the Leading Item

[`var leadingItem: CPMessageLeadingItem`](/documentation/CarPlay/CPMessageListItemLeadingConfiguration/leadingItem)

The configuration’s item.

[`enum CPMessageLeadingItem`](/documentation/CarPlay/CPMessageLeadingItem)

The accessories that a message list item can display in its leading region.

### Getting the Configuration’s State

[`var leadingImage: UIImage?`](/documentation/CarPlay/CPMessageListItemLeadingConfiguration/leadingImage)

The configuration’s image.

[`var isUnread: Bool`](/documentation/CarPlay/CPMessageListItemLeadingConfiguration/isUnread)

A Boolean value that determines whether the message list item displays an unread indicator.

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CVarArg`](/documentation/Swift/CVarArg)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

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)