Push Stories

Push Stories is a new type of Push Notification introduced by Braze. It allows customers to send down multiple ‘pages’, which consists of an image, click action, title, and description to a device. The users can iterate through these pages and go through the ‘story’ as told by each marketer.

Android Example (Expanded) IOS Example (Expanded)
AndroidPreview IOSPreview

Pre-requisites: Users must update to the latest version of Android(version:2.2.0+) and iOS (version: 3.2.0+)

Dashboard Changes

Composerdropdown Within the campaign set up dashboard, once you have selected what Push Message Variants you want, you must select Push Stories as the notification type for the Push Story Composer to appear.

New Composer


The Push Story composer is controlled by a drop-down at the top. You can choose to send a Standard Push Notification as you would today or send a Push Story Notification instead.

To create a page:

  • Click “Manage Pages” from the main composer.
  • Insert an image for each page, along with the click behavior for that image.
  • Title/Description for each page can also be inserted (if inserted for one page, they must be inserted for all pages).
  • The previews will be reflected and are interactive.

Push Stories Analytics


The analytics will look very similar to the current analytics section for Push Notification. The only difference is when you open the “Direct Opens” section, you can now see clicks per page.


Can I target users who clicked a particular page in the Push Story?

Push Story Segmentation is now available! 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.

I sent myself a Push Story on iOS but did not receive the notification - what happened?

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/or 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 on iOS but saw the condensed view instead - what happened?

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.

New Stuff!