What types of headers can I use in a WhatsApp template?
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 ConfirmationIncorrect (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
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 |
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.
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: 12/01/2026