---
title: headerImage
framework: carplay
role: symbol
role_heading: Instance Property
path: carplay/cplistsection/headerimage
---

# headerImage

An image that the section header displays.

## Declaration

```swift
@NSCopying var headerImage: UIImage? { get set }
```

## Discussion

Discussion The maximum size of the section header image is CPMaximumListSectionImageSize. Provide a UIImage that is display-ready. To provide an image that includes light and dark styles, use an asset from your asset catalog that includes both styles, or use a UIImageAsset to combine two UIImage instances into a single image with both styles. To size your header image properly, consider the display scale of the car screen. Use UIImageAsset to combine multiple images with different trait collections into a single image. For more information about trait collections for CarPlay, see carTraitCollection.

## See Also

### Configuring Section Headers

- [headerButton](carplay/cplistsection/headerbutton.md)
- [headerSubtitle](carplay/cplistsection/headersubtitle.md)