Templates
Media Size Guidelines
Recommended image and video sizes for WhatsApp message templates.
Why Media Size Matters
When you add images or videos to your template header, WhatsApp will crop or resize them to fit the chat bubble. Using the recommended sizes ensures your media looks sharp and displays correctly on all devices.
Image Guidelines
Supported Aspect Ratios
| Aspect Ratio | Pixel Example | Best For |
|---|---|---|
| Square (1:1) | 1080 x 1080 px | Product photos, profile images |
| Wide (12:7) | 1200 x 700 px | Promo banners, landscape visuals |
| Ultra Wide (3:1) | 1500 x 500 px | Thin banners, simple text-based headers |
Image Specs
| Spec | Requirement |
|---|---|
| Max file size | 5 MB |
| Recommended formats | JPEG, PNG |
| Minimum width | 600 px |
Square (1:1) is the safest choice - it displays consistently across all phone sizes and looks good in the chat bubble.
Images larger than 5 MB will fail to upload. Compress your images before uploading if needed.
Video Guidelines
Supported Aspect Ratios
| Aspect Ratio | Pixel Example | Best For |
|---|---|---|
| Wide (12:7) | 1200 x 700 px | Landscape product demos, tutorials |
| Square (1:1) | 1080 x 1080 px | Social media-style clips, versatile format |
| Portrait (5:7) | 750 x 1050 px | Vertical videos, mobile-friendly content |
Video Specs
| Spec | Requirement |
|---|---|
| Max file size | 16 MB |
| Supported formats | MP4, 3GP |
| Video codec | H.264 |
| Audio codec | AAC |
| Audio streams | Single audio stream or no audio |
| Minimum width | 600 px |
Keep videos short (under 30 seconds) for better engagement. Customers are more likely to watch short, focused clips.
Only H.264 video codec and AAC audio codec are supported. Videos using other codecs will not play correctly.
Quick Reference
| Media Type | Max Size | Recommended Ratio | Formats |
|---|---|---|---|
| Image | 5 MB | 1:1 (Square) | JPEG, PNG |
| Video | 16 MB | 1:1 (Square) | MP4, 3GP |
Common Questions
WhatsApp will automatically crop or resize it to fit the chat bubble. This may cut off important parts of your image. Use the recommended aspect ratios to avoid this.
WhatsApp templates do not support GIF files. Use a short MP4 video instead.
Check that your video is under 16 MB, uses H.264 video codec with AAC audio, and is in MP4 or 3GP format. Videos with unsupported codecs or multiple audio streams will be rejected.