Images and Rich Media

Adding additional media to notifications.


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.

FiletypesRecommended: jpg

jpeg, png
Recommended: jpg

jpeg, png, gif
ResolutionRecommended: 2:1 aspect ratio landscape

Common sizes:

Max width: 2000 pixels
Min width: 300 pixels
Recommended: 2:1 aspect ratio landscape

Common sizes:

Max width: 2000 pixels
Min width: 300 pixels
API Parameterbanner_urlbanner_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

AttachmentFile TypeMax Size
Audioaif / aiff5MB

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.