# 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://support2.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><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr></thead><tbody><tr><td><div><div>`<ACCESS_TOKEN>`</div><div>*String*</div></div></td><td><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><div><div>```
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
```

</div></div></td></tr><tr><td><div><div>`<API_VERSION>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Graph API version.</div></div></td><td><div><div>v25.0</div></div></td></tr><tr><td><div><div>`<MEDIA_CAPTION_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Media asset caption text.</div><div>Maximum 1024 characters.</div></div></td><td><div><div>`The best succulent ever?`</div></div></td></tr><tr><td><div><div>`<MEDIA_ID>`</div><div>*String*</div></div></td><td><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><div><div>`1013859600285441`</div></div></td></tr><tr><td><div><div>`<MEDIA_URL>`</div><div>*String*</div></div></td><td><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><div><div>`https://www.luckyshrub.com/assets/succulents/aloe.png`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp user phone number.</div></div></td><td><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>