Push Stories
This reference article covers what Push Stories are, how to create one, as well as some frequently asked questions.
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) |
---|---|
![]() |
![]() |
On iOS SDK versions 3.13.0+, due to a change in how the SDK downloads images, a thumbnail of the first image will not show on the condensed view of the push. Ensure that your message copy prompts users to expand the push to see the images.
Prerequisites
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:
- Click Manage Pages from the main composer.
- Insert an image for each page, along with the click behavior for that image.
- 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.
If you are pulling in images with Connected Content, ensure that your image URL begins with https://
. Using http://
will crash your app.
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.
Troubleshooting
I sent myself a Push Story on iOS 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 on iOS 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.