What file types and sizes are supported on WhatsApp?

Question

What are the file limitations of WhatsApp with Vonage Messages API?

Applies To

Messages API
WhatsApp

Answer

For Cloud-API numbers (numbers hosted in WhatsApp cloud platform):

Media	Supported Types	Size Limit
audio	`audio/aac`, `audio/mp4`, `audio/mpeg`, `audio/amr`, `audio/ogg` (only `opus codecs`, base `audio/ogg` is not supported)	16MB
document	`text/plain`, `application/pdf`, `application/vnd.ms-powerpoint`, `application/msword`, `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document`, `application/vnd.openxmlformats-officedocument.presentationml.presentation`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`	100MB
image	`image/jpeg`, `image/png` Images must be 8-bit, RGB or RGBA	5MB
video	`video/mp4`, `video/3gp` Notes: Only H.264 video codec and AAC audio codec is supported. We support videos with a single audio stream or no audio stream.	16MB
sticker	`image/webp`	Static Stickers: (100KB) Animated Stickers: (500KB) and dimensions must be (512x512 pixels)

For On-premise numbers (numbers hosted by the Vonage platform) :

Media	Supported Types	Size Limit
audio	`audio/aac`, `audio/mp4`, `audio/amr`, `audio/mpeg`, `audio/ogg; codecs=opus` Note: For ogg/opus, only single channel audio files are supported by WA clients.	16MB
document	Any valid MIME-type.	100MB
image	`image/jpeg`, `image/png` Currently, we don't support images with transparent backgrounds.	5MB
video	`video/mp4`, `video/3gp` Notes: Only H.264 video codec and AAC audio codec is supported. We support videos with a single audio stream or no audio stream.	16MB
sticker	`image/webp`	Static Stickers: (100KB)

Note: Following the announcement by Meta that the WhatsApp On-Premise API will be sunset, the Vonage On-Premise API (Vonage Hosting) is now deprecated. All WhatsApp numbers will be migrated to Cloud API (WhatsApp Hosting).

Vonage API Help Center

Question

Applies To

Answer

Articles in this section