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

# CFBundlePrimaryIcon

The app’s primary icon for display on the Home Screen, in the Settings app, and many other places throughout the system.

## Discussion

Discussion In your app for iOS, iPadOS, or watchOS, the value is a dictionary that contains the keys and values listed below. In your app for tvOS or visionOS, the value is a string that names an icon in your app’s asset catalog.

## Topics

### Specifying app icon files

- [CFBundleIconFiles](bundleresources/information-property-list/cfbundleicons/cfbundleprimaryicon/cfbundleiconfiles.md)
- [UIPrerenderedIcon](bundleresources/information-property-list/cfbundleicons/cfbundleprimaryicon/uiprerenderedicon.md)

### Customizing the App Shortcuts platter

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

### Associating an SF Symbol

- [CFBundleSymbolName](bundleresources/information-property-list/cfbundleicons/cfbundleprimaryicon/cfbundlesymbolname.md)

## See Also

### Property List Keys

- [CFBundleAlternateIcons](bundleresources/information-property-list/cfbundleicons/cfbundlealternateicons.md)