> ## 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.

# Fix WhatsApp error 131053: media upload failed

> WhatsApp error 131053 means Meta couldn't use the image, video, audio or document in your message, usually its format or size. How to find and fix it.

**Error 131053** means Meta couldn't upload or use the media in your message. The usual cause is a file WhatsApp doesn't support, or a file whose real type doesn't match its name, such as an iPhone HEIC photo saved with a `.jpg` ending. A file over WhatsApp's size limit, or a link Meta can't download, can also cause it. Resending the same file fails again.

> [!NOTE]
>
> Meta's wording: *Unable to upload the media used in the message.* Meta's fix is to check the file's real type and confirm it's a supported format. Meta's message usually explains more in its details.

## What causes it

| Cause | Example |
| - | - |
| Unsupported format | A HEIC or GIF image, a MOV video, or a ZIP file |
| File type doesn't match its contents | A HEIC photo renamed to `.jpg`, or a Word file renamed to `.pdf` |
| File too large | An image over 5 MB or a video over 16 MB |
| Video encoded in a way WhatsApp rejects | H.264 High profile, or audio that isn't AAC |
| A link Meta can't download | A file behind a sign-in, an expired link, or a link that redirects |

For every limit, see [Media formats and sizes](https://knowledge.flowella.io/whatsapp/messaging/media-specs.md).

## How to confirm it in Flowella

* **Inbox and Send log.** WhatsApp's own wording with the code 131053, followed by Meta's details.
* **Template editor.** Flowella checks the format and size of a header file before it uploads it, so most problems show in the editor rather than as 131053.
* **HubSpot.** The failed step's **Error code** output is `FAILED`, or `FLOWELLA_META:generic` if WhatsApp refused the template straight away.

## How to fix it

**1. Check the file's real type**

On macOS or Linux, run `file -I yourfile.jpg`. If the result doesn't match the ending, export the file again in a supported format.

**2. Check the size and encoding**

Keep images under 5 MB and video under 16 MB. Re-encode video as H.264 Main or Baseline with AAC audio. Flowella does this for videos you upload in the editor.

**3. Check any link you send**

For a header file sent from your own link, make sure the link opens without a sign-in and returns the file with the right content type.

**4. Upload the file again and resend**

In the template editor, upload the corrected file. Resend the messages that failed.

## Related codes

| Code | What it's about | Guide |
| - | - | - |
| **131052** | Meta couldn't download a file a customer sent you | [WhatsApp error codes](https://knowledge.flowella.io/whatsapp/errors/error-codes.md#sending-messages) |
| **132000** | The template's variables or header don't match the send | [Error 132000](https://knowledge.flowella.io/whatsapp/errors/error-132000.md) |

## Related

* [Media formats and sizes](https://knowledge.flowella.io/whatsapp/messaging/media-specs.md)
* [Media in template headers](https://knowledge.flowella.io/app/media-in-template-headers.md)
* [WhatsApp error codes](https://knowledge.flowella.io/whatsapp/errors/error-codes.md)

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


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