Change a user's App Icon (iOS 10.3+)

With iOS 10.3, Apple added a new feature that allows you to change your app icon on the fly. Rather than resubmitting your app to the App Store for each change, you can now add alternate icons ahead of time and switch between them using your code, or using Leanplum.

Overview

In our latest SDK (2.0.0), we have added support for changing app icons, which allows you to change your icon -- for just a select group of users, or all -- from the Leanplum dashboard.

There are four ways to do so:

  1. In-App Action: immediately changes the icon, and only displays a confirmation message to the user after doing so.
  2. In-App Message with Action: changes the icon after a user interacts with the in-app message. Depending on the message template, you can set the Dismiss, Cancel, or Accept action to Change App Icon.
  3. Push notification with Open Action: immediately changes the icon after the user opens the push notification.
  4. App Inbox Message with Open Action: immediately changes the icon after the user opens the message.

Before getting started, be sure you have followed our instructions to Update your app to support alternate icons.

Send an In-app Action

Leanplum lets you directly change a user's app icon with an In-app Action.

  1. From the Message Compopser, select In-app > Actions > Change App Icon.
    inAppAction.png
  2. In the Compose settings, click the row iOSAppIcon row to select the new App Icon.
  3. Choose the Icon file.
    inAppActionSelectIcon.png
  4. Add any segments (to set different icons for different users, or different regions). Hover over the iOSAppIcon cell and click the symbol. Then, click into the file cell to edit/select an icon.
    inAppActionSegments.png
  5. Set your targeting criteria (defaults to All Users).
  6. Set the delivery type (Immediate, Scheduled, Triggered, etc.).
  7. Click Send Now / Schedule.

Send an In-app Message with an Action

If you want to give the user a choice, you can use an in-app message with an Accept Action. Each user will have the option to decline the icon change. Given that, the best template to use is the Confirm in-app message. 

  1. From the Message Composer, select In-app > Confirm.
  2. Customize you message as would normally.
  3. Set the Accept Action to Change App Icon.
  4. Click the row iOSAppIcon row to select the new App Icon.
  5. Choose the Icon file.
    iamAction.png
  6. Add any segments (to set different icons for different users, or different regions). Hover over the iOSAppIcon cell and click the symbol. Then, click into the file cell to edit/select an icon.
  7. Set your Targets (defaults to All Users).
  8. Set the Display when criteria.
  9. Click Start.

Note: While you can use other in-app message templates and set Cancel or Decline actions to Change App Icon, it's best practice to use either the Confirm, Center Popup, or Interstitial templates since these all feature an Accept Action. 

Send a Push Notification with Open Action

If you want to make the Icon change immediately, you can use a push notification with an Open Action (the action that will occur immediately after a user opens the push notification):

  1. From the Message Composer, select Push Notification.
  2. Set the Open Action to Change App Icon.
    pushOpenAction.png
  3. Add any segments (to set different icons for different users, or different regions). Hover over the iOSAppIcon cell and click the symbol. Then, click into the file cell to edit/select an icon.
    pushOpenActionSegments.png
  4. Set your targeting criteria (defaults to All Users).
  5. Schedule the message.
  6. Click Send Now / Start / Schedule.

Send an App Inbox Message with Open Action

You can also send an App Inbox Message to reset/change the user's App Icon.

  1. From the Message Composer, select App Inbox Message.
  2. Set the Open Action to Change App Icon.
  3. Add any segments (to set different icons for different users, or different regions). Hover over the iOSAppIcon cell and click the symbol. Then, click into the file cell to edit/select an icon.
    appInboxAction.png
  4. Set your targeting criteria (defaults to All Users).
  5. Schedule the message.
  6. Click Send Now / Start / Schedule.

 


Was this article helpful?
Have more questions? Submit a request