# Media | Developer Documentation

<div id="bkmrk-mediaupdated%3A-dec-11">## Media

<div><span>Updated: Dec 11, 2025</span></div><div>You use 4 different endpoints to manage your media:</div><div>See [Supported Media Types](#bkmrk-supported-media-type-1) for supported types and size limits.</div><div id="bkmrk-get-media-id"><div id="bkmrk-get-media-id-1"><div>### Get media ID

</div></div></div><div>Some of the API requests described in this document require a media ID. Media IDs are returned by the API when [uploading media](#bkmrk-upload-media-1), and are included in incoming media messages webhooks ([image messages](/books/meta-whatsapp/page/image-messages-developer-documentation), [video messages](/books/meta-whatsapp/page/video-messages-developer-documentation), etc.)</div><div>Media IDs returned by the API expire after 30 days. Media IDs in webhooks expire after 7 days.</div><div id="bkmrk-delete-media"><div id="bkmrk-delete-media-1"><div>### Delete media

</div></div></div><div id="bkmrk-download-media"><div id="bkmrk-download-media-1"><div>### Download media

</div></div></div><div>To download media, make a `GET` request on the media URL and include your access token. **If you omit your token, the request will fail.**</div><div>Note that when retrieving a media from a media ID received via webhook, the media ID will only be available to download for 7 days.</div><div id="bkmrk-supported-media-type"><div id="bkmrk-supported-media-type-1"><div>### Supported media types

</div></div></div><div id="bkmrk-audio"><div id="bkmrk-audio-1"><div>#### Audio

</div></div></div><div><table><thead><tr><th><span>Audio Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>AAC</div></div></td><td><div><div>.aac</div></div></td><td><div><div>audio/aac</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>AMR</div></div></td><td><div><div>.amr</div></div></td><td><div><div>audio/amr</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>MP3</div></div></td><td><div><div>.mp3</div></div></td><td><div><div>audio/mpeg</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>MP4 Audio</div></div></td><td><div><div>.m4a</div></div></td><td><div><div>audio/mp4</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>OGG Audio</div></div></td><td><div><div>.ogg</div></div></td><td><div><div>audio/ogg (OPUS codecs only; base audio/ogg not supported; mono input only)</div></div></td><td><div><div>16 MB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-document"><div id="bkmrk-document-1"><div>#### Document

</div></div></div><div><table><thead><tr><th><span>Document Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>Text</div></div></td><td><div><div>.txt</div></div></td><td><div><div>text/plain</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Excel</div></div></td><td><div><div>.xls</div></div></td><td><div><div>application/vnd.ms-excel</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Excel</div></div></td><td><div><div>.xlsx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.spreadsheetml.sheet</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Word</div></div></td><td><div><div>.doc</div></div></td><td><div><div>application/msword</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Word</div></div></td><td><div><div>.docx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.wordprocessingml.document</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft PowerPoint</div></div></td><td><div><div>.ppt</div></div></td><td><div><div>application/vnd.ms-powerpoint</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft PowerPoint</div></div></td><td><div><div>.pptx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.presentationml.presentation</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>PDF</div></div></td><td><div><div>.pdf</div></div></td><td><div><div>application/pdf</div></div></td><td><div><div>100 MB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-image"><div id="bkmrk-image-1"><div>#### Image

</div></div></div><div>Images must be 8-bit, RGB or RGBA.</div><div><table><thead><tr><th><span>Image Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>JPEG</div></div></td><td><div><div>.jpeg</div></div></td><td><div><div>image/jpeg</div></div></td><td><div><div>5 MB</div></div></td></tr><tr><td><div><div>PNG</div></div></td><td><div><div>.png</div></div></td><td><div><div>image/png</div></div></td><td><div><div>5 MB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-sticker"><div id="bkmrk-sticker-1"><div>#### Sticker

</div></div></div><div>WebP images can only be sent in [sticker messages](/documentation/business-messaging/whatsapp/messages/sticker-messages).</div><div><table><thead><tr><th><span>Sticker Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>Animated sticker</div></div></td><td><div><div>.webp</div></div></td><td><div><div>image/webp</div></div></td><td><div><div>500 KB</div></div></td></tr><tr><td><div><div>Static sticker</div></div></td><td><div><div>.webp</div></div></td><td><div><div>image/webp</div></div></td><td><div><div>100 KB</div></div></td></tr></tbody></table>

</div><div id="bkmrk-video"><div id="bkmrk-video-1"><div>#### Video

</div></div></div><div>Only H.264 video codec and AAC audio codec supported. Single audio stream or no audio stream only.</div><div>Note that videos encoded with the H.264 “High” profile and B-frames are not supported by Android WhatsApp clients. We recommend that you use H.264 “Main” profile without B-frames, or the H.264 “Baseline” profile when encoding (or re-encoding with a tool like ffmpeg), and place moov boxes before mdat boxes, for broader compatibility. If you are using ffmpeg, you can use the -movflags faststart flag to place moov boxes before mdata boxes.</div><div><table><thead><tr><th><span>Video Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>3GPP</div></div></td><td><div><div>.3gp</div></div></td><td><div><div>video/3gpp</div></div></td><td><div><div>16 MB</div></div></td></tr><tr><td><div><div>MP4 Video</div></div></td><td><div><div>.mp4</div></div></td><td><div><div>video/mp4</div></div></td><td><div><div>16 MB</div></div></td></tr></tbody></table>

</div><div>Note that mismatched MIME type (`131053`) is a common error. Inspect your media files to verify their MIME type. Make sure that your file name extensions reflect their types. For example, if you are using UNIX, you can inspect a file via the command line to determine its MIME type:</div><div>`file -I your-image-asset.png`</div><div id="bkmrk-media-message-downlo"><div id="bkmrk-media-message-downlo-1"><div>### Media message download constraints

</div></div></div><div>The maximum supported file size for media messages on Cloud API is 100MB. In the event the customer sends a file that is greater than 100MB, you will receive a webhook with error code [131052](/documentation/business-messaging/whatsapp/support/error-codes#other-errors) and `title`:</div><div>*“Media file size too big. Max file size we currently support: 100MB. Please communicate with your customer to send a media file that is smaller than 100MB”*.</div><div>Send customers a warning message that their media file exceeds the maximum file size when this webhook event is triggered.</div><div id="bkmrk-learn-more"><div id="bkmrk-learn-more-1"><div>### Learn more

</div></div></div><div>WhatsApp Business Blog – [Sending WhatsApp media messages from an app<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fblog%2Fmedia-messages-via-app&h=AT56g_m791Hz2vyNNxrkcc3oGe9djDJ55IquMcadv5v_8g862_4P3sB_VC52BnOQahwV3sbhmBSXmha494eux1vBjaR8-pM7XdPamcQtB_Qgsx5KHVpQGBMSFf8_-fFzeVUm0Q56pkIhHFrJyzL0Fg)</div></div>