---
title: CPListTemplateDetailsHeader
framework: carplay
role: symbol
role_heading: Class
path: carplay/cplisttemplatedetailsheader
---

# CPListTemplateDetailsHeader

A header for list templates that displays rich media content with action buttons.

## Declaration

```swift
@MainActor class CPListTemplateDetailsHeader
```

## Overview

Overview CPListTemplateDetailsHeader provides a prominent header section for list templates that includes a thumbnail image, title, subtitle, and configurable action buttons. This component is ideal for displaying media items, content details, or featured items at the top of a list template in CarPlay applications. The header supports: A thumbnail image with overlay and progress indicators Primary title and subtitle text Up to a maximum number of action buttons for user interaction Automatic layout and styling appropriate for CarPlay interfaces This class is designed specifically for CarPlay templates and follows CarPlay design guidelines for typography, spacing, and interaction patterns. The header automatically adapts to different screen sizes and orientations while maintaining optimal readability and touch target sizes.

## Topics

### Initializers

- [init(coder:)](carplay/cplisttemplatedetailsheader/init(coder:).md)
- [init(thumbnail:title:subtitle:actionButtons:)](carplay/cplisttemplatedetailsheader/init(thumbnail:title:subtitle:actionbuttons:).md)
- [init(thumbnail:title:subtitle:bodyVariants:actionButtons:)](carplay/cplisttemplatedetailsheader/init(thumbnail:title:subtitle:bodyvariants:actionbuttons:).md)

### Instance Properties

- [actionButtons](carplay/cplisttemplatedetailsheader/actionbuttons.md)
- [bodyVariants](carplay/cplisttemplatedetailsheader/bodyvariants.md)
- [subtitle](carplay/cplisttemplatedetailsheader/subtitle.md)
- [thumbnail](carplay/cplisttemplatedetailsheader/thumbnail.md)
- [title](carplay/cplisttemplatedetailsheader/title.md)
- [wantsAdaptiveBackgroundStyle](carplay/cplisttemplatedetailsheader/wantsadaptivebackgroundstyle.md)

### Type Properties

- [maximumActionButtonCount](carplay/cplisttemplatedetailsheader/maximumactionbuttoncount.md)
- [maximumActionButtonSize](carplay/cplisttemplatedetailsheader/maximumactionbuttonsize.md)

## Relationships

### Inherits From

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

### Conforms To

- [CPPlayableItem](carplay/cpplayableitem.md)
- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)
- [Sendable](swift/sendable.md)