Learn how to add images, gifs, and multimedia to mobile push notifications using OneSignalβs Dashboard and API, including recommended formats, device-specific behavior, and rich media customization options.
big_picture
(Android) and ios_attachments
(iOS)Add images in the OneSignal Dashboard via the 'Image' field.
iOS | Android | |
---|---|---|
Filetypes | jpg , jpeg , png , gif | jpg , jpeg , png , gif * |
Resolution | 1:1 aspect ratio or 2:1 aspect ratio (e.g., 1038x1038px or 1024Γ512px )Max Width: 2000px Min Width: 300px | 2:1 aspect ratio (e.g., 1024Γ512px )Max Width: 2000px Min Width: 300px |
API Parameter | ios_attachments | big_picture |
UNNotificationContentExtension
to enable rich media and interactivity in notifications.
Supported features:
UNNotificationContentExtension
on iOS.
?file=video.mp4
) so the SDK can detect the media type.Attachment | File Type | Max Size | Requirements |
---|---|---|---|
Audio | aif , aiff , wav , mp3 | 5MB | None |
Video | mp4 , mpeg , mpeg2 , mpeg4 , avi | 50MB | UNNotificationContentExtension |
Image | jpg , jpeg , png , gif | 10MB | OneSignalNotificationServiceExtension |