Add Images and Media to Messages

Use images and video to increase engagement with your messages. You can add media by URL, or use Airship to host your media (if your account is CDN-enabled).

Airship media requirements

Airship hosted files must be smaller than 2MB. However, for most message types, it is recommended that you restrict your media to 1 MB or smaller. While Airship supports larger file sizes, your audience’s ability to receive media may be limited by their download speeds. If media is too large and takes too long to download, your message may render without it.

Media that you host yourself must use HTTPS.

iOS media requirements

iOS supports image, animated gif, audio, and video files.

In the API, iOS media uses the for "media_attachment" key; see the API reference for more information.

Media must be:

  • Image formats: JPEG, GIF, PNG
  • Audio formats: AIFF, WAV, MP3, M4A
  • Video formats: AVI, MPEG, MPEG2, MP4
  • Smaller than 2 MB (for uploads only)


  • Hide iOS 10 thumbnail: By default, message alerts display image thumbnails.

  • Media Specific Content: By default, iOS 10+ devices receive the Same push notification as pre-iOS 10 devices. If you want to send a different message to iOS 10+ devices, select Write Alternative, and enter alternative message text in the iOS 10 Push Notification field.

  • Alternate Title and Summary fields appear only if the Title and Summary options preceding Media are enabled and filled out.

Android and Amazon media requirements

Images must be:

  • JPEG, GIF, or PNG format
  • Smaller than 2 MB

When sending a Push notification using the API, you can set a style property with additional options to present media (i.e. big picture). See the API reference for "style".

Web notification media requirements

Media for web notification only appears to your audience members using Chrome and Opera browsers on Windows and Android platforms.

Images must be:

  • JPEG, JPG, or PNG
  • Smaller than 2 MB (for uploads only)

MMS media requirements

MMS messages support JPEG, PNG, or GIF files.

  • JPEG, JPG, and PNG files must be 2MB or smaller.
  • GIF files must be 1MB or smaller.

Upload media for a message

Wherever you have the option to add media to a message — MMS messages, the Media option for App push notifications, Icon for Web notifications, or Sound for iOS.

If your Airship plan is CDN-enabled, you can Upload media to Airship and use Airship as your media host. Airship provides a list of files that you’ve uploaded, so you can select files you’ve used before in your message.

In the Content step of your message:

  1. Select Media or another content option that takes video, images, or audio.

  2. Select Upload and click Insert Media.

  3. Click Choose file to upload a new file or use the search bar to find media that you previously uploaded.

  4. Click Insert selected media to use the media in your message.

Upload media to an HTML or rich message

When using the WYSIWYG editor for HTML emails, landing pages, and message center messages, you can add media to your message.

In the Content step of your message, when using the WYSIWYG editor to build your HTML message:

  1. Click an existing Image block or drag an *Image block into your message.

  2. Click Upload Image.

  3. Click Choose file to upload a new file or use the search bar to find media that you previously uploaded.

  4. Click Insert selected media to use the media in your message.

Host your own media

Wherever you can use media in Airship, you can provide an HTTPS, audience-accessible URL for your media. URL-referenced media follows the same rules as uploaded media, depending on the channel(s) you selected for your message.

Personalize media URLs

If you host your own media, you can personalize media URLs using HandlebarsAirship’s message personalization syntax using double curly braces, more commonly known as {{handlebars}}. Use handlebars to insert variables and conditional logic in messages and templates. , so that each member of your audience receives media that resonates with them. When you personalize media for your App channel, you have to specify the media type for your personalized media.

You should use the default handler ($def) when personalizing media URLs to make sure that your media URL resolves appropriately if variables in the URL are empty or don’t exist.

You can personalize media URLs using custom event properties, AttributesMetadata that you can use to group and target your audience. Attributes differ from tags in that when evaluating users with attributes, Airship uses operators, e.g., equals, less than/greater than, contains, before/after, to determine whether or not to target a user. Supported attribute types are TEXT, NUMBER, and DATE. , and custom properties in create-and-send lists.

Example personalized Media URL{{$def user_profile_image "default.png"}}