Swift World: Change your app’s icon programmatically in iOS 10.3

The icon of Apple’s official Clock app is amazing because it gives us a running clock. Although we can’t get this with public API, a small step forward has been taken in iOS 10.3. We can change our app’s icon programmatically.

Let’s get started.


Obviously, we need to prepare different icons. There are some requirements. The first one is size. For example, if our app is only for iPhone, the sizes are 60pt@2x and 60pt@3x which means 120120 and 180180. And its names should follow the rules like icon1@2x.png and icon1@3x.png. The second one is where we put the alternate icons. Generally, we put our app icon in Assets.xcassets, but not for the alternative icons. We usually put it in a group specifically for alternative icons.

The alternative app icon in our example is the following image.

Register in Info.plist

As the first step, we need to register our alternative icons in Info.plist. Normally, we put app icon in Assets.xcassets and alternative icons in a specific group. For example the alternate icon in our example is AlternateIcon.png in group AleternateIcon. The following steps are taken to register it.

  1. Add row and select “Icon files (iOS 5)” in Info.plist.
  2. Add new entry CFBundleAlternateIcons
  3. Add new entry for alternative icon
  4. Add file name to item in CFBundleIconFiles

The final Info.plist is like the following.

The new dictionary entry CFBundleAlternateIcons is specific for alternative icons. It works with previous keys like CFBundleIcons and CFBundlePrimaryIcon to record the informations about icons. In every categories, the array value for key CFBundleIconFiles includes the icon files.

The Info.plist in raw format will show us the structure clearly.


Information Property List Key Reference gives detailed explanation. The relevant sections are CFBundleIcons, Contents of the CFBundlePrimaryIcon Dictionary Entry and Contents of the CFBundleAlternateIcons Dictionary Entry.

work in code

Let’s start coding. The following is new APIs we will use.

UIApplication.shared.supportsAlternateIcons is

A Boolean value indicating whether the app is allowed to change its icon. — from Apple Developer Documentation
func setAlternateIconName(_ alternateIconName: String?,
completionHandler: ((Error?) -> Void)? = nil)
Use this method to change your app’s icon to its primary icon or to one of its alternate icons. You can change the icon only if the value of the supportsAlternateIcons property is true. — from Apple Developer Documentation

UIApplication.shared.setAlternateIconName(nil) means use primary app icon.

We add a toggle button to change the icon

@IBOutlet weak var changeIconBtn: UIButton!
@IBAction func changeIcon(_ sender: UIButton) {
if UIApplication.shared.supportsAlternateIcons {
if let alternateIconName = UIApplication.shared.alternateIconName {
print("current icon is \(alternateIconName), change to primary icon")
} else {
print("current icon is primary icon, change to alternative icon")
UIApplication.shared.setAlternateIconName("AlternateIcon"){ error in
if let error = error {
} else {

The final result is shown in the video.

Thanks for your time. Please click the ❤ button to get this article seen by more people.