Skip to content

Push settings

When creating a push campaign through the dashboard, click the Settings tab on the Compose step to view the advanced settings available.

Key-value pairs

Braze allows you to send custom-defined string key-value pairs, known as extras, along with a push notification to your application. Extras can be defined via the dashboard or API and will be available as key-value pairs within the notification dictionary passed to your push delegate implementations.

Alert options

Select the Alert Options checkbox to see a dropdown of key-values available to adjust how the notification appears on devices.

Adding content-available flag

Check the Add Content-Available Flag checkbox to instruct devices to download new content in the background. Most commonly, this can be checked if you are interested in sending silent notifications.

Adding mutable-content flag

Check the Add Mutable-Content Flag checkbox to enable advanced receiver customization. This flag will automatically be sent when composing a rich notification, regardless of the value of this checkbox.

Update app badge count

Enter the number that you want to update your badge count to or use Liquid syntax to set custom conditions. You can also update a message badge count programmatically: refer to our dedicated badge count article.


If you want your push notification to be accompanied by a custom sound when it is received, use the Sound field to specify the protocol URL of your sound file. For more on customization, refer to our custom sounds article.

Collapse ID

Specify a collapse ID to coalesce similar notifications. If you send multiple notifications with the same collapse ID, the device will only show the most recently received notification. Refer to Apple’s documentation on coalesced notifications.


Checking the Expiry checkbox will allow setting an expiration time for your message. Should a user’s device lose connectivity, Braze will continue to try and send the message until the specified time. If this is not set, the platform will default to an expiration of 30 days. Note that push notifications that expire before delivery are not considered failed and will not be recorded as a bounce.

New Stuff!