⚡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.
Related Articles
What Excel/CSV format do I need so template variables map correctly?
⚡Quick answer - Create a .CSV or .XLSX file with clear, lowercase headers (e.g., customer_name, amount, date). Clean every value, keep one row per contact, then map each column to its matching template placeholder on the variable-mapping screen. ...
How do button types and button organising rules work in a WhatsApp message template?
⚡Quick answer - WhatsApp templates allow either (a) up to 2 Call-to-Action (CTA) buttons—1 Phone + 1 URL—or (b) up to 3 Quick Reply buttons. Mixing CTA and Quick Reply buttons in the same template is never allowed, and all Quick Replies must appear ...
What is Message Trail and how do I use it to track automated WhatsApp template messages in MyOperator?
⚡Quick answer - Message Trail lets you tag any WhatsApp template message sent via our API with a custom trail name (e.g., “OrderStatusUpdates”) and then view real-time delivery, read, and reply stats—plus export a detailed CSV report—right from your ...
How many variables can I use in the WhatsApp template body, and can I use variables in the footer?
⚡ Quick answer — • There is no hard limit on the number of placeholders (variables) you can add in the body of a WhatsApp template, as long as the combined text + variables stays within 1024 characters. • No, WhatsApp does not allow variables ...
How many variables can I use in the WhatsApp template body, and can I use variables in the footer?
⚡ Quick answer — • There is no hard limit on the number of placeholders (variables) you can add in the body of a WhatsApp template, as long as the combined text + variables stays within 1024 characters. • No, WhatsApp does not allow variables ...