> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp media formats and size limits

> File types and size limits WhatsApp accepts for images, video, audio, documents and stickers, video codec rules, how long media lasts, and error 131053.

WhatsApp accepts images up to **5 MB** (JPEG, PNG or static WebP), video up to **16 MB** (MP4 or 3GPP, H.264 with AAC audio), audio up to **16 MB**, documents up to **100 MB** (PDF, Word, Excel, PowerPoint or plain text) and stickers up to **100 KB** static or **500 KB** animated. A file in the wrong format, or with a file type that doesn't match its contents, fails with **131053**. Customers can send you files up to **100 MB**.

> [!NOTE]
>
> **In Flowella.** Partly supported. Template headers and carousel cards take JPEG or PNG images, MP4 video and PDF documents, and Flowella checks each file before it uploads. It also re-encodes an MP4 that wouldn't play on Android WhatsApp. You can't attach files from the Inbox, but you can record voice messages there. Customers' photos, videos, voice notes and documents appear in the Inbox. See [Media in template headers](https://knowledge.flowella.io/app/media-in-template-headers.md).

## Meta's limits

### Images

| Format | MIME type | Maximum size |
| - | - | - |
| JPEG | `image/jpeg` | 5 MB |
| PNG | `image/png` | 5 MB |
| Static WebP | `image/webp` | 5 MB |

Images must be 8-bit RGB or RGBA. Meta rejects images over 4,096 pixels on any edge, and animated WebP images. A static WebP sent as an image is converted to JPEG.

### Video

| Format | MIME type | Maximum size |
| - | - | - |
| MP4 | `video/mp4` | 16 MB |
| 3GPP | `video/3gpp` | 16 MB |

* Video must use the H.264 codec with AAC audio, and one audio track or none.
* Android WhatsApp can't play H.264 **High** profile video with B-frames. Use the **Main** profile without B-frames, or **Baseline**.
* Put the file's index (`moov` box) at the start of the file. With ffmpeg, use `-movflags faststart`.

### Audio

| Format | MIME type | Maximum size |
| - | - | - |
| AAC | `audio/aac` | 16 MB |
| AMR | `audio/amr` | 16 MB |
| MP3 | `audio/mpeg` | 16 MB |
| MP4 audio | `audio/mp4` | 16 MB |
| OGG | `audio/ogg`, Opus codec and mono only | 16 MB |

### Documents

| Format | Extension | Maximum size |
| - | - | - |
| PDF | `.pdf` | 100 MB |
| Word | `.doc`, `.docx` | 100 MB |
| Excel | `.xls`, `.xlsx` | 100 MB |
| PowerPoint | `.ppt`, `.pptx` | 100 MB |
| Plain text | `.txt` | 100 MB |

### Stickers

| Type | MIME type | Maximum size |
| - | - | - |
| Static sticker | `image/webp` | 100 KB |
| Animated sticker | `image/webp` | 500 KB |

## How long media lasts

| Item | Lifetime |
| - | - |
| Media you upload to Meta | 30 days, unless deleted sooner |
| A media ID from an upload | 30 days |
| A media ID in a customer's message | 7 days |
| A media download link | 5 minutes, then a new one is needed |
| A file sent from your own link | Meta caches it for 10 minutes and reuses it for the same link |

## What Flowella accepts

| Where | Accepted | Limit |
| - | - | - |
| Template image header and carousel card | JPEG or PNG | 5 MB |
| Template video header and carousel card | MP4. Flowella re-encodes it for Android if needed. | 16 MB after re-encoding |
| Template document header | PDF, with the file name the customer sees | 100 MB |
| Inbox | Voice messages you record. No file attachments. | |
| HubSpot **AI Document Reader** | PDF, JPEG, PNG and WebP | 15 MB |

## Errors

| Code | What it means | What to do |
| - | - | - |
| **131053** | Meta couldn't use your media, usually because the format isn't supported or the file type doesn't match the contents. | Check the file is one of the formats above and under the limit. For video, use H.264 Main or Baseline with AAC audio. If you send from your own link, check the link returns the file with the right content type. |
| **131052** | Meta couldn't download a file a customer sent you, for example because it's over 100 MB. | Ask the customer to send a smaller file, or send it another way. |
| **131051** | The message type isn't supported. | Send a supported message type. |

## Related

* [Media in template headers](https://knowledge.flowella.io/app/media-in-template-headers.md)
* [Template reference](https://knowledge.flowella.io/app/template-reference.md)
* [Inbox](https://knowledge.flowella.io/app/inbox.md)
* [WhatsApp error codes](https://knowledge.flowella.io/whatsapp/errors/error-codes.md)

Checked against Meta's [Media](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media), [Service messages](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages#media-caching) and [WhatsApp error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes) pages on 18 November 2026.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.