Media Size Guidelines
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 |
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 |
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
What happens if my image is the wrong size?
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.
Can I use GIFs?
WhatsApp templates do not support GIF files. Use a short MP4 video instead.
Why does my video fail to upload?
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.
Updated on: 21/04/2026
Thank you!