Is there any size limit on the media files attached in WhatsApp Template Messages?
Yes. WhatsApp sets strict file size limits for media attachments used in template messages. Going over these limits will result in rejection or API errors.
đź—‚ Supported Media Types & Size Limits
Media Type | Max File Size | Recommended Specs | Remarks |
Image (JPEG, PNG) | Up to 5 MB | Aspect ratio: 1.91:1 or 1:1 | Commonly used in header media |
Sticker (WebP) | Up to 500 KB | Square, 512x512 px recommended | For template headers only |
Video (MP4) | Up to 16 MB | H.264 codec, AAC audio | Accepted as header media |
Audio (AAC, MP4, AMR, OPUS) | Up to 16 MB | AAC/MP4 recommended | Limited to standalone messages, not headers |
Document (PDF, DOC, PPT, etc.) | Up to 100 MB | PDFs preferred for compatibility | Can be included in header |
⚠️ What Happens If You Exceed the Limit?
- Template Rejection: Meta will reject your submission during approval.
- API Error Response: The Cloud API will throw a media size error.
Example Error Response:
{ "error": { "message": "Media file size too large", "type": "OAuthException", "code": 131051, "error_subcode": 2494010, "fbtrace_id": "AbCdEf123456" }}âś… Best Practices
- Images & Stickers: Keep images under 5 MB, WebP under 500 KB.
- Videos: Compress to ≤16 MB using H.264/AAC.
- Documents: ≤100 MB, PDFs preferred.
- Audio: Ensure ≤16 MB and proper encoding (AAC recommended).
- Always preview: Test media before submitting the template.
đź–Ľ Visual Infographic: WhatsApp Media Size Limits
đź“š References
Related Articles
What media formats are supported in a WhatsApp Template Message?
⚡Quick answer - Every WhatsApp Template Message must contain body text. Media is optional and, if used, appears only in the Header. Supported header formats are JPG/JPEG/PNG for images within 5MB, MP4 videos within 16MB, and documents (PDF) within ...What kind of Template Messages does WhatsApp approve?
Since October 2021, WhatsApp has expanded the scope of approved Template Messages. Businesses can now use them not only for transactional updates but also for promotional and follow-up engagement—provided they comply with WhatsApp’s Business Policy ...What types of headers can I use in a WhatsApp template?
⚡Quick answer - A WhatsApp template supports one optional header that appears at the top of your message. You can choose only one type per template (Text, Image, Video, or Document) — or no header at all. Different header types cannot be combined. ...What is Message Trail and how do I use it to track automated WhatsApp template messages in MyOperator?
⚡Quick answer - Message Trail lets you tag any WhatsApp template message sent via our API with a custom trail name (e.g., “OrderStatusUpdates”) and then view real-time delivery, read, and reply stats—plus export a detailed CSV report—right from your ...Do these WhatsApp Template Messages need to be approved by the WhatsApp Team?
Yes — every WhatsApp Template Message must be reviewed and approved by Meta (formerly Facebook) before it can be used. This ensures compliance with WhatsApp’s Business Policy and guarantees that your messages can be reliably delivered to customers. ...