What media formats are supported in a WhatsApp Template Message?

Info

Quick answer — Every WhatsApp Template Message must contain body text. Media is optional and, if used, appears only in the header. Supported header formats: images (JPG, JPEG, PNG) up to 5 MB; videos (MP4) up to 16 MB; documents (PDF) up to 10 MB.

When should I use this guide?

Consult it before submitting a template to be sure your media type, size, and formatting meet WhatsApp rules—avoiding one of the most common rejection reasons.

1. Supported media formats (header only)

Media Type	Supported Formats	Max Size	Ideal Use Case
Image	JPG, JPEG, PNG	5 MB	Product photos, service visuals
Video	MP4	16 MB	Demo clips, promotional intros
Document	PDF	10 MB	Invoices, brochures, policies

Warning

You cannot send a template with media only—body text is mandatory.

2. 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"
  }
}

3. Example template message

Header: Image (product photo)

Body: "Hi {{1}}, your order #{{2}} has been shipped."

Sample values: "Hi Sarah, your order #1234 has been shipped."

4. Compliance notes

Body text is mandatory.
File names should be clean (no spaces, symbols, emojis).
Media must relate directly to the template content.
Unsupported formats or oversized files result in rejection.

5. Best-practice checklist

✔️ Compress media before upload.
✔️ Include clear body text that explains the attachment.
✔️ Preview the template to confirm correct rendering.
✔️ Avoid unrelated stock visuals.
✔️ Test file size on Wi‑Fi and mobile data.

Keywords: WhatsApp template media, header image size, supported formats, body text required

Updated on: 09/01/2026