Image block
Displays an image, with an optional title above it.
| Type | image |
| Available in | Messages, Modals, Home tab |
Fields
Section titled “Fields”| Field | Type | Description | Required? |
|---|---|---|---|
type |
String | The type of block. For an image block, type is always image. |
Required |
alt_text |
String | A plain-text summary of the image, without markup. Maximum 2000 characters. | Required |
image_url |
String | The http(s) URL of a publicly hosted image (png, jpg, jpeg, gif). Maximum 3000 characters. |
Required |
title |
Text object | A title shown above the image, as a plain_text text object. Maximum 2000 characters. |
Optional |
block_id |
String | A unique identifier for the block. Maximum length is 255 characters. It must be unique within the message or view — a duplicate is replaced and reported as a warning. | Optional |
Examples
Section titled “Examples”An image with a title
Section titled “An image with a title”
{ "blocks": [ { "type": "image", "title": { "type": "plain_text", "text": "Shelf audit — Store 12, aisle 4" }, "image_url": "https://picsum.photos/id/292/800/500", "alt_text": "Store shelf photographed during the audit" } ]}An image without a title
Section titled “An image without a title”
{ "blocks": [ { "type": "image", "image_url": "https://picsum.photos/id/48/800/450", "alt_text": "Office meeting room set up for the quarterly review" } ]}