<!--
{
  "availability" : [
    "iOS: 5.0.0 -",
    "iPadOS: 5.0.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/Information-Property-List/CFBundleIcons/CFBundleAlternateIcons",
  "metadataVersion" : "0.1.0",
  "role" : "Property List Key",
  "symbol" : {
    "kind" : "Property List Key",
    "modules" : [
      "Bundle Resources"
    ],
    "preciseIdentifier" : "plist:Information_Property_List.CFBundleIcons.CFBundleAlternateIcons"
  },
  "title" : "CFBundleAlternateIcons"
}
-->

# CFBundleAlternateIcons

A list of alternate icons for the Home screen and Settings app.

## Discussion

The value of this key is different in iOS and tvOS.

In tvOS, the value of the key is an array of strings. The value of each string is the name of an icon file in your app.

In iOS, the value of the key is a dictionary.
The key for each dictionary entry is the name of the alternate icon, which is also the string you pass to <doc://com.apple.documentation/documentation/UIKit/UIApplication/setAlternateIconName(_:completionHandler:)> when changing icons.
The value for each dictionary key is an [`AppIconReferenceName`](/documentation/BundleResources/Information-Property-List/CFBundleIcons/CFBundleAlternateIcons/AppIconReferenceName) dictionary.

## Topics

### Property List Keys

[`AppIconReferenceName`](/documentation/BundleResources/Information-Property-List/CFBundleIcons/CFBundleAlternateIcons/AppIconReferenceName)


---

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)