App Push: Media Specifications

This document outlines the media and sound format requirements for each APN layout. Follow the format, size, and compatibility requirements to ensure optimal rendering across Android and iOS.

📘
Note

Refer the document by Apple here for size supported in iOS for Rich Media.

Image Layout Options: When uploading images for rich media push notifications on iOS, you have two configuration options to control how your visuals display:
i. Recommended Size (Default): Applies the standard 2:1 landscape crop. Use this to ensure quick layout consistency across common device types.
ii. Original Size: Displays the exact image size uploaded without cropping. Use this option to bypass the layout cropper entirely and maintain your asset's native vertical, square, or panoramic layout.

Refer to the table below to understand the format specifications.

Layout Name	Template Name	Subsection	Field	Value(Applicable for)
Regular layouts	Create a customised template with rich media like images, audio files, GIFs.	Rich Media Includes below types for regular layout Images Carousel Audio GIF	File Types	Image and Carousel: `.png`, `.jpg`, `.jpeg` Audio(iOS):`.aiff`, `.wav`, `.caf` Audio(Android): `.mp3`, `.ogg`, `.wav` GIF:`.gif`
			Max Size	Upload File (Image): Max size500 KB and Min size 40 KB URL (only for Carousel): Max size: 100 KB per image GIF: 2MB.
			Aspect Ratio	Image: 2:1 (Expanded State) Carousel (Portrait) : 1:1
			URL Requirement	Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
			Performance Note	GIFs: Larger images render as simple notifications on iOS (30-second timeout). SDK will render as simple notification on iOS as 30 secs time is available to download the resource.
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`

Refer below to understand the format specifications for Advance layouts:

Layout Name	Template Name	Subsection	Field	Value(Applicable for)
Advance layouts	Overlay on Image: This layout allows you to display a message over an image.	It has below subsections: Rich Media-Image	File Types	Image:`.png`, `.jpg`, `.jpeg`
			Max Size	Image: Max size: 500 KB and Min size 40 KB
			Aspect Ratio	Image:2:1 (Expanded State)
			MIME Types	Image:2:1 (Expanded State) Image(Only Android): 4:1 (Customize Collapsed State)
			URL Requirement	Image: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	Timer:Create a customised template with rich media like images, audio files, GIFs.	Rich Media Includes below types for regular layout Images Carousel Audio GIF	File Types	Image and Carousel: `.png`, `.jpg`, `.jpeg` Audio(iOS):`.aiff`, `.wav`, `.caf` Audio(Android): `.mp3`, `.ogg`, `.wav` GIF:`.gif`
			Max Size	Image: 500 KB and Min size 40 KB Carousel: Max size: 100 KB per image GIF:2 MB
			Aspect Ratio	Image:2:1 (Expanded State) GIF:Suggested frame=15 Image(Only Android): 4:1 (Customize Collapsed State)
			URL Requirement	Image: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
			Performance Note	Image and GIF: Larger images render as simple notifications on iOS (30-second timeout)
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	E2E Carousel template	It has below subsections: Rich Media-Image	Image File Types	`.png`, `.jpg`, `.jpeg`
			Max Size	Max size: 100 KB per image
			Aspect Ratio	2:1 (Expanded State)
			Customized Collapsed State (Android)	2:1 (Text with Image) 4:1 (Only Images)
			URL Requirement	Image: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
			Images requirement	2 images (Minimum) 5 images (Maximum)
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	Edge to Edge	It has below subsections: Rich Media-Image	Image File Types	`.png`, `.jpg`, `.jpeg`
			Max Size	Max size 500 KB and Min size 40 KB
			Aspect Ratio	2:1 (Expanded State)
			Customized Collapsed State (Android)	1:1
			URL Requirement	Image: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	Rating	It has below subsections: Rating Settings: Custom Rating Icon	File Type	`.png`
			Max Size	10 KB
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	Small image		Image File Types	`.png`, `.jpg`, `.jpeg`
			Size	Max500 KB and Min 40 KB
			Aspect Ratio	1:1
			URL Requirement	Image: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	Progress Bar		Image File Types	`.png`, `.jpg`, `.jpeg`
			Unsupported Media	Carousel, Audio, GIF
			Size	Max: 500 KB and Min 40 KB
			Aspect Ratio	2:1
			URL Requirement	Image: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	Multi-Icon	It has below subsections: Rich Media-Image	Icon File Types	`.png`, `.jpg`, `.jpeg`
			Max Size	100 KB per image (upload) 200 KB (URL)
			Aspect Ratio	1:1
			URL Requirement	Icon: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`
	Quick Reply	It has below subsections: Rich Media-Image	Icon File Types	`.png`, `.jpg`, `.jpeg`
			Max Size	500 KB and Min size 40 KB (upload)
			Aspect Ratio	2:1
			URL Requirement	Image: Must include HTTPS protocol with a supported file format.
			Max URL Length	1000 characters
		Custom sound file name	File Types	iOS: `.aiff`, `.wav`, or `.caf` Android:`.mp3`, `.ogg`, and `.wav`

📘Note

📘
Note