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

# CPListTemplateDetailsHeader

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

```
@MainActor class CPListTemplateDetailsHeader
```

## 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

\discussion 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: NSCoder)`](/documentation/CarPlay/CPListTemplateDetailsHeader/init(coder:))

[`init(thumbnail: CPThumbnailImage, title: String?, subtitle: String?, actionButtons: [CPButton])`](/documentation/CarPlay/CPListTemplateDetailsHeader/init(thumbnail:title:subtitle:actionButtons:))

Creates a new details header with the specified content and action buttons.

[`init(thumbnail: CPThumbnailImage, title: String?, subtitle: String?, bodyVariants: [NSAttributedString], actionButtons: [CPButton])`](/documentation/CarPlay/CPListTemplateDetailsHeader/init(thumbnail:title:subtitle:bodyVariants:actionButtons:))

Creates a new details header with the specified content and action buttons.

### Instance Properties

[`var actionButtons: [CPButton]`](/documentation/CarPlay/CPListTemplateDetailsHeader/actionButtons)

An array of action buttons displayed in the header.

[`var bodyVariants: [NSAttributedString]`](/documentation/CarPlay/CPListTemplateDetailsHeader/bodyVariants)

An optional array of strings, ordered from most to least preferred.

[`var subtitle: String?`](/documentation/CarPlay/CPListTemplateDetailsHeader/subtitle)

The secondary subtitle text displayed below the title.

[`var thumbnail: CPThumbnailImage`](/documentation/CarPlay/CPListTemplateDetailsHeader/thumbnail)

The thumbnail image displayed in the header.

[`var title: String?`](/documentation/CarPlay/CPListTemplateDetailsHeader/title)

The primary title text displayed in the header.

[`var wantsAdaptiveBackgroundStyle: Bool`](/documentation/CarPlay/CPListTemplateDetailsHeader/wantsAdaptiveBackgroundStyle)

A Boolean value that determines whether to use a custom background style.

### Type Properties

[`class var maximumActionButtonCount: Int`](/documentation/CarPlay/CPListTemplateDetailsHeader/maximumActionButtonCount)

The maximum number of action buttons that can be displayed in the header.

[`class var maximumActionButtonSize: CGSize`](/documentation/CarPlay/CPListTemplateDetailsHeader/maximumActionButtonSize)

## Relationships

### Conforms To

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

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

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

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

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

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

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

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

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

[`NSCoding`](/documentation/Foundation/NSCoding)

### 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)