What media formats are supported in a WhatsApp Template Message?

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 10MB.

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

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

Template section with media information

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

    • Related Articles

    • 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. ...

    • 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 ...

    • How to submit a New WhatsApp Template Message?

      To send proactive messages such as alerts, OTPs, or promotions via WhatsApp, you need to create and submit a template message. These templates must be approved by Meta before they can be used in business-initiated conversations. ? Prerequisites ...

    • What languages are supported for WhatsApp templates?

      ⚡Quick answer - MyOperator supports the following three English language variants for template creation: English (default) English (US) English (UK) Each template must be submitted in one of the languages only. Can I Use Other Languages? Officially, ...

    • What is a WhatsApp Template Message?

      A WhatsApp Template Message is a pre-approved message format that businesses use to initiate conversations with customers outside the 24-hour service window. These templates help maintain compliance with WhatsApp’s rules while ensuring messages are ...