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

WhatsApp Template Headers

A WhatsApp template supports one optional header that appears at the top of your message.

Warning : 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: No variables or emojis allowed

✅ Correct example: Order Confirmation

❌ Incorrect (dynamic, no longer supported): Order #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	Example Use Case
📝 Text	60 characters	Plain text only	“Order Confirmation”
🖼️ Image	5 MB	JPEG, JPG, PNG	Product photo / Promo banner
🎥 Video	10 MB	MP4	Demo / Tutorial clip
📄 Document	10 MB	PDF	Invoice / Receipt / Policy doc

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.

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.

Updated on: 22/09/2025