# Image messages | Developer Documentation

<div id="bkmrk-image-messagesupdate">## Image messages

<div><span>Updated: Nov 3, 2025</span></div><div>Image messages are messages that display a single image and an optional caption.</div><div>![](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-cz2terue.png)</div><div id="bkmrk-request-parameters"><div id="bkmrk-request-parameters-1"><div>### Request parameters

</div></div></div><div><table style="width:100%;table-layout:fixed;"><thead><tr><th style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;width:28%;overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><span>Placeholder </span></th><th style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;width:47%;overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><span>Description </span></th><th style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;width:25%;overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><span>Example Value </span></th></tr></thead><tbody><tr><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`<ACCESS_TOKEN>`</div><div>*String*</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>**Required.**</div><div>[System token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation) or [business token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation).</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`EAAAN6tcBzAUBOZC82CW...DOMccqHEZD`</div></div></td></tr><tr><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`<API_VERSION>`</div><div>*String*</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>**Optional.**</div><div>Graph API version.</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>v25.0</div></div></td></tr><tr><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`<MEDIA_CAPTION_TEXT>`</div><div>*String*</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>**Optional.**</div><div>Media asset caption text.</div><div>Maximum 1024 characters.</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`The best succulent ever?`</div></div></td></tr><tr><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`<MEDIA_ID>`</div><div>*String*</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>**Required if using uploaded media, otherwise omit.**</div><div>ID of the [uploaded media asset](/books/meta-whatsapp/page/media-developer-documentation).</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`1013859600285441`</div></div></td></tr><tr><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`<MEDIA_URL>`</div><div>*String*</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>**Required if using hosted media, otherwise omit.**</div><div>URL of the media asset hosted on your public server. For better performance, we recommend using `id` and an [uploaded media asset ID](/books/meta-whatsapp/page/media-developer-documentation) instead.</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`https://www.luckyshrub.com/assets/succulents/aloe.png`</div></div></td></tr><tr><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>**Required.**</div><div>WhatsApp business phone number ID.</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`106540352242922`</div></div></td></tr><tr><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>**Required.**</div><div>WhatsApp user phone number.</div></div></td><td style="overflow-wrap:anywhere;word-break:break-word;vertical-align:top;"><div><div>`+16505551234`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-supported-image-form"><div id="bkmrk-supported-image-form-1"><div>### Supported image formats

</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>