CarPlay CPGridTemplate – buttons show in a row, and limited to 9 buttons

Hi,

I’m working with CPGridTemplate in CarPlay. According to the documentation, it supports up to 9 CPGridButton objects and should display them in a grid (up to 3×3).

However, I’ve run into two issues:

Row instead of grid

When I add 4–6 buttons, they don’t appear in a 2×2 or 2×3 grid. Instead, they are shown in a single

horizontal row. Even 9 buttons do not appear in a 3x3 grid.

More than 9 buttons

My use case requires more than 9 icons, but it looks like CPGridTemplate ignores any additional buttons beyond the first 9. Is there any supported way to display more than 9 buttons in a grid, or is pagination/multiple templates the only option?

Thanks in advance!

Hi, your first issue - grid items in a single row - should be resolved on the latest iOS 26 beta. Can you confirm if you are still seeing this on iOS 26 beta 6?

For your second issue, the maximum number of items in a grid template is given by the constant CPGridTemplateMaximumItems, which is 8 as of iOS 26. If you need more icons, please file a feedback request with more details about your use case. Thanks!

CarPlay CPGridTemplate – buttons show in a row, and limited to 9 buttons
 
 
Q