<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "watchOS: 10.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/Information-Property-List/CFBundleIcons/CFBundlePrimaryIcon/NSAppIconComplementingColorNames",
  "metadataVersion" : "0.1.0",
  "role" : "Property List Key",
  "symbol" : {
    "kind" : "Property List Key",
    "modules" : [
      "Bundle Resources"
    ],
    "preciseIdentifier" : "plist:Information_Property_List.CFBundleIcons.CFBundlePrimaryIcon.NSAppIconComplementingColorNames"
  },
  "title" : "NSAppIconComplementingColorNames"
}
-->

# NSAppIconComplementingColorNames

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

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

1. Specify the name of a single custom color in your app’s asset catalog to show a solid background.
2. 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.

```swift
<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.

```swift
<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>
```

---

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)