What types of headers can I use in a WhatsApp template?

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.

Headers help grab attention or add media context, but they must follow Meta’s format and size guidelines.

1. Text Header

  • Limit: Max 60 characters
  • Best for: Short static titles like “Order Confirmation” or “New Offer”
  • Restrictions: Only 1 variable {{ }} allowed in Text option.
  • Correct Example:
    Order Confirmation

Incorrect (dynamic, no longer supported):
Order #{{1}} has shipped!

2. Image Header

  • Limit: Max 5MB
  • Formats: JPEG, JPG, PNG
  • Best for: Product images, QR codes, receipts

Example Use Case: A banner image for a promotional campaign

3. Video Header

  • Limit: Max 10MB
  • Format: MP4
  • Best for: Demos, onboarding clips, teaser promotions
  • Tip: Keep videos under 15 seconds for faster loading

Example Use Case: A short product demo clip

4. Document Header

  • Limit: Max 10MB
  • Format: PDF only
  • Best for: Invoices, receipts, policies

Example Use Case: “View your updated invoice” with attached PDF

Comparison Table of Header Types

Header Type

Max Size

Format

Text

60 characters

Plain text only

Image

5 MB

JPEG, JPG, PNG

Video

10 MB

MP4

Document

10 MB

PDF

Important Rules

  • You can add only one header type (text, image, video, or document).
  • The header is optional, but once added, it must meet format and size requirements.
  • Meta will reject templates with unsupported formats, oversized files, or disallowed content.

✨ Pro Tip: Use headers to highlight critical info visually (like an invoice PDF or promo banner), while keeping personalization in the body section of your template.