---
title: NSAppIconComplementingColorNames
framework: bundleresources
role: symbol
role_heading: Property List Key
path: bundleresources/information-property-list/cfbundleicons/cfbundleprimaryicon/nsappiconcomplementingcolornames
---

# NSAppIconComplementingColorNames

The names of the colors to use for the background of the App Shortcuts platter.

## Discussion

Discussion By default, the system chooses an appropriate background color for the App Shortcuts platter — a view that represents a single group of App Shortcuts. You can override that behavior in one of two ways: Specify the name of a single custom color in your app’s asset catalog to show a solid background. Specify the names of two custom colors to show a gradient background. important: Use array for the value’s type, even when specifying a single custom color for a solid background. <dict>      <key>CFBundlePrimaryIcon</key>      <dict>          <key>NSAppIconActionTintColorName</key>          <string>CustomTintColor</string>          <key>NSAppIconComplementingColorNames</key>          <array>              <string>BackgroundGradientColor1</string>              <string>BackgroundGradientColor2</string>          </array>     </dict> </dict> If your app provides multiple app icons, you can specify different background colors to match each alternative. <dict>      <key>CFBundlePrimaryIcon</key>      <dict>          <key>NSAppIconActionTintColorName</key>          <string>CustomTintColor</string>          <key>NSAppIconComplementingColorNames</key>          <array>              <string>BackgroundGradientColor1</string>              <string>BackgroundGradientColor2</string>          </array>     </dict>     <key>CFBundleAlternateIcons</key>      <dict>          <key>MyAlternateIcon</key>          <dict>             <key>NSAppIconActionTintColorName</key>             <string>AlternateCustomTintColor</string>             <key>NSAppIconComplementingColorNames</key>             <array>                 <string>AlternateBackgroundGradientColor1</string>                 <string>AlternateBackgroundGradientColor2</string>             </array>          </dict>     </dict> </dict>

## See Also

### Customizing the App Shortcuts platter

- [NSAppIconActionTintColorName](bundleresources/information-property-list/cfbundleicons/cfbundleprimaryicon/nsappiconactiontintcolorname.md)