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.

    experience push message screen

  2. Type a name for this message.

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

    • Content

      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 Requirements for Rich Push Notifications below.


      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.
    • Destination

      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.


      When you use the * Web Link or Custom Link destination types, the destination type is not tracked. Only Deep Links are tracked.

Requirements for rich push notifications

Here are the requirements for sending rich push notifications:

  • Supported Versions

    Rich push notifications are supported on the following versions:

    • Android 4.1.0 or later

    • iOS 10 or later


      Remember the following information:

      • Rich push messages sent to earlier versions will still be sent but only the text is 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 Formats

    • HTTPS only
  • Sizing

    • Images must be in a 2:1 format, or they are cropped.

To configure a push message on the Experience page:

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

    • Payload: Data

      Provide a custom push payload in JSON that is 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.

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

    • x Summary

      Hides the preview pane. Click preview to display the preview pane again.

    • Change the orientation

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

    • Preview on a user’s watch

      To preview your message as it will appear on a users’s watches click watch icon.

    • Preview on a user’s mobile phone

      To preview your message as it will appear on a users’s mobile phones click phone icon.

    • Preview on a user’s tablet

      To preview your message in a user’s tablet, click tablet icon.

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

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

  4. 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.

  5. Configure the scheduling options for the message.

    For more information, see Schedule: push message.

On this page