Skip to content

Push Stories

Push Stories are a new type of push notification introduced by Braze. This feature takes the photo carousel functionality popularized in Instagram and Facebook and allows marketers to create a carousel of pages within a push that tells a rich, cohesive story. These pages consist of an image, click action, title, and description. Your users can swipe through these pages and view the story—as told by you.

Android Example (Expanded) IOS Example (Expanded)


The following SDK versions are required to receive Push Stories:

How to use Push Stories

To use Push Stories, create a push campaign and select Push Stories as your Notification Type.

Push Story composer

To create a page, perform the following steps:

  1. Click Manage Pages from the main composer.

  2. Insert an image for each page, along with the click behavior for that image.
  3. If desired, add a Title and Description for each page. If you use a title and description for one page, they must be inserted for all pages.

The previews will be reflected and are interactive.

Image and text specifications

The following image and text specifications apply to the photo carousel portion of Push Stories. For information on the basic push that users interact with to activate the Push Story, refer to the text guidelines for push.

  • Image ratio: 2:1 (required)
  • Recommended image size: 500 KB
  • Max image size: 5 MB
  • File types: PNG, JPEG
  • Title: 30 characters (recommended)
  • Description: 30 characters (recommended)

Push Story segmentation

When you create a campaign or Canvas, you can filter which users you want to target based on whether they have clicked on a Push Story page. Then, select the campaign and the page you want to use to target your users.

Push Stories analytics

The analytics will look very similar to the current analytics section for push notifications. For Push Stories analytics, you can open the Direct Opens metric to view the clicks per page.

iOS Push Performance table with sample analytics and expanded details for the Direct Opens metric.



I sent myself a Push Story but didn’t receive the notification

Apple has specific rules in place that will prevent certain types of notifications from being sent to a device based on a number of different factors. This includes evaluating the customers’ data plan, notification size, and the customers’ storage capacity. As a result, sometimes no notification will be sent to your customers.

These are limitations imposed by Apple that should be considered when designing your Push Story.

I sent myself a Push Story but saw the condensed view instead

In certain situations where all the pages do not load, for example, due to a loss of data connection, the Push Story will only show the condensed notification.


Push Story doesn’t dismiss after clicking the image

By default, Push Stories are not dismissed on Android after a user clicks on the image. If you’d like to dismiss the notification, call cancelNotification.

New Stuff!