Something BIG is happening to our documentation! Check back in early October!

Creating a News Feed Item

Push Messages, Emails, and In-App messages are wonderful but ephemeral content. Once swiped away, you lose your opportunity to engage. If you catch a user at the wrong time, that message is lost to them forever. Multi-Channel messaging helps to ameliorate this problem, but the News Feed really puts it to rest once and for all.

News-Feed items allow you to insert permanent content directly into your app from our web dashboard. Better yet, the news feed also is targetable to individual segments just like all of our other message types. This means what you see in the feed might be completely different from another individual. The possibilities for the news-feed are nearly limitless.

To see examples of News Feeds, check out our Client Integration Gallery.

Step 1: Click Create Card

First you must choose the type of News Feed item you want to send down to your users. From the dropdown menu, you can select any of our four News Feed card types.


News Feed Card Specifications

News Feed Cards

Classic Card

Standard news feed cards consist of:

  • 110x110 image
  • Title
  • Body Text
  • Link (In-App/Web)

Captioned Image Cards

Captioned Image

Captioned Image cards consist of:

  • 600x450 image
  • Title
  • Body Text
  • Link (In-App/Web)


Banner cards consist of:

  • 600x100 image
  • Link (In-App/Web)

Cross Promotions Cards


Cross promotion cards allow you to showcase another app that’s in the app store. Note that you may not advertise apps which are the property of companies other than your own.

Image guidelines

Card type Aspect Ratio Recommended Image Size Maximum Image Size File Types
Classic 1:1 (110 pixels wide minimum) 500KB 1MB PNG, JPG, GIF
Captioned image 4:3 (600 pixels wide minimum) 500KB 1MB PNG, JPG, GIF
Banner 6:1 (600 pixels wide minimum) 500KB 1MB PNG, JPG, GIF
  • PNG files are recommended.
  • The Facebook’s Fresco Image Library is required in order to display Gifs on Android.
  • Smaller, high quality images will load faster, so it’s recommended to use the smallest asset possible to achieve your desired output.

News Feed Title Summary

Time to compose your News Feed card! Create a title and summary for your card and upload an image to go alongside it. You can also set link behavior on this page. This link can be a standard link or a “Deep Link” to in-app content.

Step 3: Select A Schedule

News Feed Schedule

Below the News Feed Card editor, you will find options for when to publish this item. You can choose to publish it immediately after creation or set a time in the future to publish it. You can also choose to deliver the News Feed card at a particular time in your users’ local time by selecting the “Publish to Users in their Local Time Zone” checkbox.

Step 4: Select a Segment

You can configure your News Feed Card to target any segment you’ve defined within the dashboard at any schedule you desire. Select your target segment by clicking on the dropdown menu. Here you can see high-level statistics, including email availability and lifetime value per user.

Target Segment

Step 5: Review Details and Publish

Next, you will be taken to a page that displays all of the details about your card (and companion In-App message, if applicable). You can review any of the details about these items and edit them if you need to by clicking the pencil icon in any of the headers.

News Feed Preview

That’s it! You’re done! You’ve published your first news-feed card!

Linked In App

Multichannel campaigns often lead to better overall conversion and engagement rates, so Braze has made it easy to link a in-app message to a specific news feed card. After launching a news feed card, a button will appear in the new feed statistics page allowing you to “create an associated in-app message.” Clicking on this will take you to the campaign composer for a new in-app message campaign. While you would input the copy, look, and feel of the in-app message, Braze automatically copies the delivery and targeting rules of the associated news feed card to make sure the campaigns launch together.

Organizing your News Feed

You can re-order your cards within Braze’s News Feed page. - Cards in the feed are ordered first by whether or not they have been seen by the user, unseen items are at the top of the feed. - A card is considered read if it has received an impression in the feed. - Impressions are only counted if the card is viewable in the feed (ie, if a user does not scroll down to read a card, an impression is not counted). - Cards are then ordered by the date and time of creation, where more recent items are first.

News Feed Categories

News Feed “Categories” make it possible to integrate multiple instances of the news feed into your application. It’s possible to integrate feeds within different windows that only display news feed cards of a certain “category.”

News Feed Categories Image

Marking a News Feed as being from a specific “category” is not visible to the end user. By default, the Braze News Feed will display cards of all categories, unless a feed is specifically configured in the app code to display specific categories. For more information on the app code configuration, please see our technical documentation on the matter.


Similar to scheduled campaigns, the News Feed tool comes with an analytics dashboard to monitor impressions, clicks, and clickthrough rates. Clicking on a specific News Feed message in your dashboard brings up a host of visual analytics to sort through. At the top of the page, you can select your data date range and see a quick visualization of your most important metrics. Additionally, you can see specifics about this News Feed message, such as when it was sent and who it was sent to.


By scrolling down the page, you can see a larger breakdown of your clicks and impressions day-by-day. Total clicks/impressions are easily compared with unique clicks/impressions through line charts, while a clickthrough rate is presented as an interactive bar chart.


Retargeting Data

You can leverage Braze’s data on which users are interacting with your News Feed via segment filters that let you retarget specific behaviors.

Feed Impression Filter

Braze automatically tracks when users view the feed and how many times they have viewed it. There are two filters available:

  • Last Viewed News Feed
  • News Feed View Count

‘Last Viewed News Feed’ is an effective way to use other channels to draw users back into the feed. This can be easily done with push and in-app notifications. Braze has seen over 100% increases in news feed impressions with effective targeting. As awareness of the feed increases, these benefits are sustained.

‘News Feed View Count’ can be used to target users who have never viewed the feed or seldom viewed the feed to encourage more impressions of your cards.

Consider, using these filters in tandem or with other filters to create an even more targeted call to action.

Clicked Card Filter

You can create segments based on how users have interacted with specific cards in the feed. The filter is in the Retargeting section of the filter list and called Clicked Card.

Has Clicked Card Filter

  • Works well to retarget users who have clicked on a card, but not followed through on your call to action.
  • It is also useful to retarget users with related content that may of interest to them.
  • You can also use this filter to target users that did not click a card. This filter can be applied to specific cards so that they disappear from a user’s feed after they click on them.
    • To set this up, after you create a card go back and edit the target segment to include ‘Has not clicked YOUR NEW CARD’.
    • After a user clicks the card, the card will automatically leave the feed when the user’s next session starts.
    • Avoid over-using this targeting because user’s may end up with empty feeds. Best practice is to use a combination of static and automatically removed content.
  • It also works well to retarget users who do not click on a card to follow up with another call to action.

has not clicked card