Rich Push Notifications


iOS 10 has introduced rich push notifications which provides the capability to add image, video, audio, or GIF attachments to your push notifications.

Rich push notifications are enabled via a notification service extension, a separate and distinct binary embedded in your app bundle. Prior to displaying a new push notification, the system will call your notification service extension to modify the payload as well as add media attachments to be displayed.

Enable Rich Push Notifications

The following section covers how to enable rich push notifications:

  1. Enable push notifications for your app.
  2. To create a notification service extension in your project, in Xcode, select File > New > Target.
  3. Choose the Notification Service Extension template.
  1. When sending notifications via APNs, include the mutable-content flag in your app payload.


Required Key

This key must be present in the app payload or the system will not call your app extension.

Send Rich Push Notifications

When using the CleverTap Dashboard to send rich push notifications:

  1. Select the Advanced checkbox.
  2. Select the Mutable Content checkbox.
  1. Add your custom key-value pair(s).

When using the CleverTap Server API to send push: include "mutable-content": "true" in the platform_specific: iOS section of the request payload.


Below are some project examples:

Did this page help you?