Optional Message Features

These optional features are available during the Content step when creating or editing a Message, Automation, A/B Test or Push Template. Each feature's purpose and settings are detailed here. See the Message Reference for API equivalents.

Note

  • Available features are dependent on which message types and platforms are selected.
  • If you have included both app and non-app platforms, non-OS-specific app-only features will be under the header App Options.
  • Not supported for Web Browsers: Buttons, Summary, Media.

Features

Buttons

Add one or two Buttons to bring even more interactivity to your messaging. Buttons prompt a user to take specific actions within or outside of the applications. Trigger any Urban Airship message action when a button is clicked. See: Interactive Notifications.

Enable via toggle, click Select buttons, either page through or type to narrow your search, and click the button(s) of your choice.

Custom Keys

The Custom Keys option only appears in the Content step when creating a push template. Otherwise this option appears in the Delivery Step. See: Optional Delivery Features: Custom Keys.

Title

Enter a Title to create a heading that appears above the notification text on:

  • iOS Notification Center
  • Apple Watch Looks
  • Android and Amazon Notification Area/Drawer

For web browsers, the title set here will override the default title.

Enable via toggle, then type the title in the text field.

Summary

Add a Summary line, supplemental text displayed with the primary notification message. Enable via toggle, then type the line in the text field.

  • iOS: Summary appears below the push notification title. See: iOS 10 documentation. iOS 10+ only.
  • Android and Amazon: Summary appears below the main notification text in most cases. This is the only visible text other than the title when Android Picture is visible in expanded mode, as the main notification text is suppressed. See: Android documentation.

Media

Add Media to your notification. Toggle to enable.

iOS

  1. Enter the URL for the media to be displayed with the push notification. Image, animated gif, audio, and video are supported. See the API reference for allowed file types and requirements. Ensure the URL will be accessible by your mobile audience. HTTPS is required.

  2. Check the box to Hide iOS thumbnail. By default, a thumbnail of the media is displayed in the message alert.

  3. Add Media Specific Content on iOS 10 devices. By default, iOS 10 devices will receive the Same push notification as pre-iOS 10 devices. If you would like to send a different message to iOS 10 devices, select the Write Alternative radio button to display the iOS 10 Push Notification box, and enter the alternative text.

Alternate Title and Summary fields will appear here only if the initial Title and Summary fields preceding Media have been enabled and filled out.

Android and Amazon

Enter the URL for the media to be displayed with the push notification. Only static images are supported. See the API reference for "style". Ensure the URL will be accessible by your mobile audience. HTTPS is required.

If the iOS platform is enabled along with Android and/or Amazon, the URL field is labeled Picture for Android. The Picture for Android field is removed if a URL for a static image is entered in the initial URL field.

Upload Media

If your account has CDN enabled, you have the option to Upload media rather than entering a URL. Select the radio button for Upload, click the Upload Media button, and select the media file. Maximum file size is 2 MB.

Supported Media

  • Images: JPEG, GIF, PNG
  • Audio: AIFF, WAV, MP3, M4A
  • Video: AVI, MPEG, MPEG2, MP4

Contact Support if you are interested in enabling CDN media hosting.

iOS Only

Badge

Update the recipient device's app Badge, the red numeric display on the app icon that typically indicates its number of unread messages.

By default you automatically increment the existing badge number, but alternatively you can specify the exact number, e.g., +3, +12, -3.

Enable via toggle, then select either Increment by 1 or Specify. Specify requires a value in the text field.

Sound

Play a custom Sound when the message is received. The file must be bundled with your app by your app developer.

Enable via toggle, then enter the name of the sound file, e.g., "default" or "beep.caf".

Android Only

Notification Category

Note

Urban Airship Notification Categories map to Android notification channels.

Send to a specific Notification Category instead of the default. A Notification Category must be configured before it will appear in the dropdown menu. See: Settings: Configuration: Android Notification Categories. Android O (8.0) only.

Enable via toggle, then select from the dropdown menu.

If no notification categories have been predefined, you will see a link to the configuration documentation.

Web Browser Only

Icon

Add an Icon for each web push notification, overriding the default configuration. Safari not supported.

Enable via toggle, then enter the URL for the media to be displayed with the web push notification. Only static images are supported. Ensure the URL will be accessible by your mobile audience. HTTPS is required.

If your account has CDN enabled, you have the option to Upload the icon image rather than entering a URL. Select the radio button for Upload, click the Upload Media button, and select the image file. Maximum file size is 2 MB.

Supported Media

  • Images: JPEG, JPG, PNG

Contact Support if you are interested in enabling CDN media hosting.