Skip to content

Rich notifications

Rich notifications are push notifications with images, GIFs, and video. To enable this functionality, you must create a notification service extension—a type of extension that enables modification of a push payload before it is displayed. Refer to Apple’s UNNotificationAttachment for a list of supported file types and sizes.

Creating a service extension

To create a notification service extension, navigate to File > New > Target in Xcode and select Notification Service Extension.

Ensure that Embed In Application is set to embed the extension in your application.

Setting up the notification service extension

A notification service extension is its own binary that is bundled with your app. It must be set up in the Apple Developer Portal with its own app ID and provisioning profile.

The notification service extension’s bundle ID must be distinct from your main app target’s bundle ID. For example, if your app’s bundle ID is, you can use for your service extension.


For a step-by-step guide on integrating rich push notifications with BrazeNotificationService, refer to our tutorial.

To see a sample, refer to the usage in NotificationService of our Examples app.

Creating a rich notification in your dashboard

Your Marketing team can also create rich notifications from the dashboard. Create a push notification through the push composer and simply attach an image or GIF, or provide a URL that hosts an image, GIF, or video. Note that assets are downloaded on the receipt of push notifications, so you should plan for large, synchronous spikes in requests if you are hosting your content.

New Stuff!