CarPlay Templates Reference
Catalog reference for the 12 CarPlay templates that iOS renders on your app's behalf. Each entry covers the template's purpose, the app categories that can use it, the iOS version that introduced it, its key constraints, and its most important properties.
When to Use This Reference
Use this reference when:
- Picking the right template for a CarPlay screen you need to build
- Checking whether a template is available for your app's category
- Looking up the depth limit before pushing another template onto the stack
- Confirming the iOS version gate for a specific template or template feature (image row item styles, message item, pinned elements, sports mode)
- Inspecting the constraints on a template (max items, max characters, asset sizes)
- Wiring up a
CPListTemplatewith sections, image rows, or limited-list mode - Configuring
CPNowPlayingTemplate.sharedbuttons at scene connection time - Building a search experience with
CPSearchTemplateand async results
Example Prompts
Questions you can ask your assistant that will draw from this reference:
- "Which CarPlay templates can my audio app use?"
- "What's the maximum template stack depth for a driving task app?"
- "How many items can I show in a grid template?"
- "When does limited list mode activate and how do I handle the 12-item cap?"
- "What's the difference between the action sheet and alert templates?"
- "How do I configure the Now Playing template's custom buttons?"
- "Which templates support pinned elements on iOS 26?"
- "What are the iOS version requirements for the new image row styles?"
What's Covered
- Template × category availability matrix – for each of the 12 templates, which of the 11 CarPlay app categories may use it (with iOS version footnotes for iOS 17+, iOS 26.4+, and iOS 27+ additions)
- Template depth limits – per-category maximum push depth (5 for audio, video, communication, EV charging, parking, public safety, and navigation; 3 for fueling and voice-based conversational; 2 or 3 for driving task and quick food ordering, depending on the iOS version), counting the root template
- Action sheet template (
CPActionSheetTemplate) – modal with 2+ choices, when to use it instead of an alert, iOS 12+ (audio iOS 17+) - Alert template (
CPAlertTemplate) – modal with one or more buttons, title-length-variant behavior, all categories, iOS 12+ - Contact template (
CPContactTemplate) – caller, messaging-contact, or point-of-interest presentation, action buttons, optional Siri compose-message bar button, Communication/Public Safety/Navigation only, iOS 14+ - Grid template (
CPGridTemplate) – up to 8 icon+title choices, 40×40 pt icon max, all categories, iOS 12+ - Information template (
CPInformationTemplate) – single or two-column static labels with optional footer actions, all except Audio and Video, iOS 14+ (nav bar buttons iOS 16+) - List template (
CPListTemplate) – the most-used template: sections, standard items, image row items (the row style from iOS 12, plus card, condensed, grid, and image grid styles from iOS 26), message items (iOS 26+), the assistant cell (iOS 15+), pinned elements (iOS 26+), limited list mode (12-item dynamic cap), and thecompletion()spinner pattern for async handlers - Map template (
CPMapTemplate) – control layer over the navigation base view, up to 2 leading + 2 trailing nav bar buttons and 4 map buttons, multitouch callbacks on iOS 26+, Navigation only - Now Playing template (
CPNowPlayingTemplate) – shared instance, configured at scene connection because iOS can show it before you push it;isAlbumArtistButtonEnabledandisUpNextButtonEnabledtoggles,updateNowPlayingButtonswithCPNowPlayingPlaybackRateButton,CPNowPlayingShuffleButton,CPNowPlayingRepeatButton,CPNowPlayingAddToLibraryButton,CPNowPlayingMoreButton, plus sports mode (iOS 18.4+) and theallowsMiniPlayerMiniPlayer opt-out (iOS 27); Audio and Video, Communication (iOS 17+), Public Safety, iOS 14+ - Point of interest template (
CPPointOfInterestTemplate) – MapKit-backed map with up to 12 location overlays, customizable pins, larger pin for the selected location (iOS 16+), Driving Task/EV/Fueling/Parking/Public Safety/QSR, iOS 14+ - Search template (
CPSearchTemplate) – search field with async results throughupdatedSearchText(_:completionHandler:)andselectedResult(_:completionHandler:); Navigation, plus Audio/Video, EV charging, Fueling, Parking, and Public Safety from iOS 27 (never quick food ordering) - Tab bar template (
CPTabBarTemplate) – top-level navigation with up to 4 tabs for audio apps and 5 for other categories (read the system maximum rather than hard-coding it), tab icons (24×24 pt; prefer SF Symbols), all categories, iOS 14+ - Voice control template (
CPVoiceControlTemplate) – voice control UI for navigation apps (iOS 12+), driving task and voice-based conversational apps (iOS 26.4+), and the remaining categories on iOS 27+; up to 2 action buttons from iOS 26.4; iOS 27 adds abackgroundImageand overlay presentation over another template throughCPInterfaceController.showOverlayTemplate(_:animated:completion:) - Asset sizes – maximum sizes for contact action buttons, grid icons, Now Playing action buttons, and tab bar icons;
carTraitCollectionfor the car's display scale;maximumImageSizefor list images; light and dark adaptation throughcontentStyle - Push and pop conventions –
CPInterfaceController.pushTemplate(_:animated:completion:)andpopTemplate(animated:completion:), and the runtime exceptions for exceeding the depth limit or using a template your category doesn't allow - Common mistakes – unsupported templates, exceeding depth, hard-coding the tab count, configuring Now Playing too late, assuming lists show every item, and using
traitCollectionfor scale
Documentation Scope
This page documents the carplay-templates-ref skill (in the axiom-media suite), the template-catalog half of CarPlay development.
- For app design discipline (category selection, the 7 Universal Guidelines, per-category rules, entitlement review), see CarPlay HIG. Start there before picking templates.
Related
- CarPlay Navigation Reference – Navigation-only framework details: base view, route guidance lifecycle, instrument cluster, HUD metadata, and multitouch
- Now Playing CarPlay Reference –
CPNowPlayingTemplatecustomization in depth: the sports mode schema, custom buttons at connection time, and CarPlay-specific gotchas
Resources
CarPlay Developer Guide (June 2026): template and category matrix and depth limits p. 14, per-template specs pp. 15–26, asset sizes pp. 28 and 39, Now Playing template code p. 33
WWDC: 2026-212, 2025-216, 2022-10016, 2020-10635, 2018-213