Skip to main content
A picture, from an https:// URL or an uploaded file_id.
​
type
string
required
"image"
​
url
string
An https:// URL, up to 2,048 characters. You must send exactly one of url or file_id.
​
file_id
string
An id from uploading a file.
​
alt
string
Up to 200 characters. Empty means the image is decoration only.
​
caption
string
Plain text, up to 500 characters. Shown under the image.
Sending both url and file_id, or neither, is an error. Pick one.
A broken image link shows a placeholder with your alt text — never an empty gap. Uploaded images get a fresh short-lived link each time the message is read.