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

# wantsAdaptiveBackgroundStyle

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

```
var wantsAdaptiveBackgroundStyle: Bool { get set }
```

## Discussion

When set to YES, the header will use a custom background style derived from
the thumbnail image. This creates an adaptive background that automatically
generates light and dark mode variants.

When set to NO (default), the header uses the standard CarPlay background.

\discussion The custom background style uses perceptually-aware color transformation
to create visually harmonious backgrounds that adapt to the user’s
interface style preference.

---

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)