Experience: Push Message

You can configure experience options for push messages and rich push messages, including name, message text, and destination options. You can also configure advanced options, including payload options and custom options for iOS devices.

  1. On the Audience page for a new push message, click Experience.

  2. Type a name for this message.

  3. Type information in the following fields in the Message section:

    Element Description


    Specify the text of your message. You can specify up to a maximum of 140 characters.

    Media URL

    Type the URL of the media file that you plan to use in the push notification message. For requirements to use rich push notifications, see Table 1.


    To display an image or a video in a push notification, remember the following:

    • The attachment-url data is handled in the push payload.

    • The media URL must be able to handle spikes requests.

    For more information about preparing your app to receive rich push notifications, see the following:


    Select a specific destination, such as a web, deep, or hybrid link, to send users when they click-through the message.

    For more information, see Destinations.

    Tip: When you use the Web Link or Custom Link destination types, the destination type is not tracked. Only Deep Links are tracked.
    Table 1. Requirements for Rich Push Notifications
    Requirement Details

    Supported Versions

    • Android 4.1.0 or later
    • iOS 10 or later
    Important: Remember the following information:
    • Rich push messages sent to earlier versions will still be sent but only text will be displayed.

    • There is no watch support at this time.

    File Formats

    Here are the supported file formats:

    • Images: JPG and PNG
    • Animations (iOS only): GIF
    • Videos (iOS only): MP4

    URL Format

    HTTPS only


    Images must be in a 2:1 format or they will be cropped.

    For more information about configuring rich push notifications, see the following content:

  4. (Optional) Click the Show Advanced Options link to configure additional options:

    Element Description

    Payload: Data

    Provide a custom push payload in JSON that will be sent to the app through a push or a local notification.

    The limit for Android and iOS is 4KB.

    Apple Options: Category

    Provide a category for push and local notifications.

    For more information, see Managing Your App’s Notification Support in the iOS Developer Library.

    Apple Options: Sound

    Provide the name of the sound file in your app bundle to play. A default alert sound plays if not set.

    For more information, see Managing Your App's Notificaton Support in the iOS Developer Library.

    Apple Options: Content Available

    Select this option so that when the message arrives, iOS wakes up your app in the background and allows your app to execute code based on the message payload.

    For more information, see Apple Push Notification Service in the iOS Developer Library

  5. (Optional) Preview the layout of your message by clicking following icons:

    Icon Description

    x Summary

    Hide the preview pane. Click to redisplay the preview pane.

    Click to change the orientation of the preview from portrait to landscape mode. For watches, the orientation changes from a round watch face to a square watch face.

    Click to preview your message as it will appear on users's watches.

    Click to preview your message as it will appear on users's mobile phones.

    Click to preview your message as it will appear on users's tablets.

    At the bottom of the preview pane, you can view a description of the audience that you selected in the previous step.

  6. (Optional) Click Test to push your message to specified devices for testing purposes.

  7. Select the service and type the push tokens for at least one device to which you want to push the message.

    Specify the tokens in a comma-separated list to push the message to more than one device.

  8. Configure Schedule options.