The WonderPush Developer Hub

Welcome to the WonderPush developer hub. You'll find comprehensive guides and documentation to help you start working with WonderPush as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Rich media

Attach high-res images, videos and audio to your notifications.

Rich media includes high-resolution images, animated GIFs, videos and audio files.

Not all platforms support all formats. This article helps you understand how to best leverage each platform's capabilities.

High-resolution images

Most devices and browser support high-resolution images, and WonderPush lets you include them in just a few clicks.

Supported formats are: JPEG, PNG and GIF.
We recommend images no larger than 1024x1024, with a maximum file size of 5 Mb.

To include high-resolution images, use the big picture notification type.

Animated GIFs

At the moment, only iOS 10+ devices support animating GIF images. Other platforms will only display the first frame of the animation.

Sending animated GIFs works exactly like sending high-resolution images, all you have to do is use a GIF image instead.

Video

Only iOS 10+ devices support video in push notifications.

To send audio or video in a push notification, you have multiple options:

  • use the big picture notification type, putting the URL of a video or audio file instead of the high-resolution image,
  • use the API to specify an attachment.

If you're using the Big Picture notification type, bear in mind that only iOS devices will see the video attachment. Other platforms will not show an attachment at all (but they will show the text). Remember that you can use segmentation to target iOS users.

Using the API, you can specify a video/audio attachment for iOS users, and another type of attachment for Android and Website users. The chapter Adapting notification content to each platform explains how to send platform-dependant notifications. Here is an example where we send a video to iOS users and an image to Web and Android users:

🚧

This example sends a notification to your entire userbase. You will most certainly want to adapt the targetSegmentId parameter.

curl -XPOST https://management-api.wonderpush.com/v1/deliveries?accessToken="YOUR_ACCESS_TOKEN" \
  -d [email protected] \
  -d notification='{"alert": {"text": "Example push notification", "ios":{"attachments":[{"url":"https://download.blender.org/peach/trailer/trailer_iphone.m4v"}]}, "android":{"type":"bigPicture", "bigPicture":"https://upload.wikimedia.org/wikipedia/commons/thumb/8/84/Example.svg/2000px-Example.svg.png"}, "web":{"image":"https://upload.wikimedia.org/wikipedia/commons/thumb/8/84/Example.svg/2000px-Example.svg.png"}}}'

Audio

Only iOS 10+ devices support audio in push notifications.
Sending audio is done exactly like sending videos:

  • using the Big Picture notification type using the URL of an audio file,
  • or using the API.

Size limitations on iOS

iOS imposes the following size limits to rich media attachments:

TypeSupported formatsMaximum size
AudioAIFF, WAV, MP3, M4A5 MB
ImageJPEG, GIF, PNG10 MB
MovieMPEG, MPEG2, MPEG4, AVI50 MB

Updated 7 months ago

Rich media


Attach high-res images, videos and audio to your notifications.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.