How to set up iOS push notifications

You will learn

Learn how to set up push notifications in your Klaviyo account. After you've completed the steps in this article, you'll be able to send push notifications in your flows and campaigns. For notifications to actually be delivered to devices, you additionally need to install the appropriate Klaviyo mobile SDK in your mobile app code and then release a new app version with the SDK installed.

Before you begin

There are 3 prerequisites for using push notifications in Klaviyo:

1. You must have your own iOS mobile app.
2. You must have an Apple Developer account in which you can generate an Apple Push Notification service (APNs) authentication key to upload to Klaviyo (more details below).
3. You must install the appropriate Klaviyo mobile SDK (iOS, React Native, or Flutter) and set up event tracking and push notifications in your iOS app.

Set up iOS push notifications in Klaviyo

1. Click your organization name in the lower left-hand corner.
2. Navigate to Settings > Push notifications.
3. On the Mobile app settings page, click Enable next to the iOS option.
   

4. Fill out the required information.
   To create the APNs authentication key, you must be the Account Holder or an Admin in your Apple Developer account. You also need access to the key’s details to copy its Key ID. You can review Apple's roles and permissions here.
   • APNs Authentication Key If you don't already have one, create an APNs authentication key with Apple Push Notification service enabled. The key must support production sends to your app’s Bundle ID. After creating your key, download the .p8 file and upload it to your Klaviyo account. Keep the file in a secure place because Apple lets you download it only once.
   • Key ID
     To find your key ID, navigate to your list of keys. Click your key to expand the details, and copy the key ID.
   • Team ID
     Find your team ID here.
   • Bundle ID
     You can find your Bundle ID in your Apple Developer account or your app’s Xcode project. To find it in App Store Connect:
     1. Log into your App Store Connect account.
     2. Click Apps and select your app.
     3. Under General > App Information in the sidebar, copy the Bundle ID and enter it in Klaviyo.
        The Bundle ID is case sensitive. Enter your app’s exact identifier, for example:
        com.YOUR_APP_NAME
        

5. After filling out all of the required information, click Save.

A success notification confirms that your iOS push configuration was saved. You now can create push notifications in campaigns and flows.

Test sending a push notification

After you have configured push notifications in your Klaviyo account and have confirmed that the Klaviyo SDK is installed in your mobile app:

1. Log into your mobile app with an email address or phone number that will make it easy to find your profile in Klaviyo.
2. If prompted, enable push notifications for your app. If you are not prompted, confirm that push notifications are enabled for the app in your device’s settings app.
3. In Klaviyo, go to Audience > Profiles and find your test profile. If you cannot find your profile, check with your app developer to confirm that your app sends profile identifiers to Klaviyo.
4. Under Channel consent, confirm that your profile is subscribed to mobile push notifications.

5. Create a list or segment with only your profile.
6. Create a push notification campaign and select that list or segment as the audience.
7. Finish creating the message and then send the campaign to your test list or segment.
8. Confirm that the notification appears on the device.
9. Tap the notification on your device to open your app.
10. Check your profile’s Activity log to confirm that you see both a Received Push event and an Opened Push event.

Troubleshooting

• Why do I not see a push token on my profile in Klaviyo? Similar to an email address for emails, push notifications are sent to push tokens. Your mobile app needs to forward a device’s push token to Klaviyo for you to be able to send push notifications to that device. Confirm with your app developer that they have implemented the code outlined in the Push Notifications section of our SDK documentation.
• Why are images not displaying for iOS push notifications? Rich media displays on iOS only if you add the Notification Service Extension to your app. Confirm with your app developer that they have implemented the code outlined in the Rich Notifications section of our SDK documentation.
• Why am I not seeing Opened Push events even when I tap on a notification? You need to add code to your mobile app to track Opened Push events in Klaviyo. Klaviyo can automatically handle this code for you, or your developer can manually add this code. Confirm with your app developer that they have implemented the code outlined in the Push Notifications section of our SDK documentation.

Additional resources

• Also have an Android app? Learn how to set up push for Android.
• Is your app built with React Native? Learn how to set up push notifications for a React Native app.
• Learn how to use push notifications for campaigns.
• Check out how to use deep links in push notifications.