Images and Rich Media

Adding additional media to notifications.

Images

Large images for App Push Notifications can be added on both Android and iOS. For Web Push, see our Web Push Notifications Guide.

App Push large images will display in the "expanded view" of the notification, generally when you long-press or swipe to view.

Images can be added to push messages using the panel or the Rest APIs.

Recommended Image Details

The recommended image is a .jpg filetype with 2:1 aspect ratio landscape and size as 512x256px or 1440x720px.

Android

iOS

Filetypes

Recommended: jpg

jpeg, png

Recommended: jpg

jpeg, png, gif

Resolution

Recommended: 2:1 aspect ratio landscape

Common sizes:
512x256px
1440x720px

Max width: 2000 pixels
Min width: 300 pixels

Recommended: 2:1 aspect ratio landscape

Common sizes:
512x256px
1440x720px

Max width: 2000 pixels
Min width: 300 pixels

API Parameter

banner_url

banner_url

  • gif image animations are not supported on Android mobile apps.
  • Adding Call to Action Buttons may affect image sizes. Please see the preview of the notification on the Send Notification page to make sure the layout fits your requirements.
  • Android 4.1+ and iOS 10+ support large images.
  • For troubleshooting, please refer to Notification Images Not Shown on Device guide.


Rich Notifications

iOS 10+

Apple introduced the concept of Rich Notifications in iOS 10, which allows deeper interaction with your app from the notification itself. These are great for short interactions that do not require the full app experience and represent the growing importance of notifications to an app's user experience.

Rich notifications side-step the process of tapping a notification, unlocking the phone, waiting for the app to load, and then interacting with the app, by creating opportunities for short interactions within the notification itself.

iZooto fully supports iOS 10 rich notifications. You can read more about Rich Notifications in our blog post on What are Rich Push Notifications?.

Media Attachments

Media attachments allow developers to attach URLs to relevant content. This is great for live events, photo tagging, and game updates, as well as all sorts of other visual content. Pictures speak a thousand words, and video more so, and with media attachments, it has never been easier to transport users into another place at the touch of a button.

Supported Media Formats

Attachment

File Type

Max Size

Audio

aif / aiff

5MB

Audio

wav

5MB

Audio

MP3

5MB

Audio/Video

MP4

5MB

Image

JPEG

10MB

Image

GIF

10MB

Image

PNG

10MB

Video

MPEG

50MB

Video

MPEG2

50MB

Video

MPEG4

50MB

Video

AVI

50MB

Make sure the hosted image, video, or audio is a direct link to the resource. If it does not end in the correct file extension (listed File Types above), you can add, for instance &file=type.mp4 (use your resource's correct file_extension) to the end of the URL so our SDK recognizes this as a media URL.

🚧

Media Uploads

iZooto does not support uploading video media. You would need to host the video on your own servers and include the URL to the resource within the ios_attachments / Media properties.


Mobile Push Image Troubleshooting

Please refer to our Notification Images Not Shown on Device troubleshooting guide for more information.


Did this page help you?