Overview

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

Rich media fields (Audio, GIF, Video) under Timer use the same specifications as listed in the Rich Media section.

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

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): 40 KB URL (only for Carousel): 200 KB 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: 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: 40 KB GIF:200 KB
			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	40 KB
			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	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`
			Max Size	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
			Max Size	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 (Coming Soon)	It has below subsections: Rich Media-Image	Icon File Types	`.png`, `.jpg`, `.jpeg`
			Max Size	40 KB (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 (Coming Soon)	It has below subsections: Rich Media-Image	Icon File Types	`.png`, `.jpg`, `.jpeg`
			Max 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`

App Push: Media Specifications

Overview

📘
Note

Overview

📘Note

📘
Note