Video
A video preview with a thumbnail, title, and provider byline.
video renders a video preview (a thumbnail with a play pill, a title, a description, and a
provider byline) the way Slack shows an unfurled video before it’s expanded into a player.
Fields
typestring
Always `video`.
stringvideo_urlstring
An embeddable video URL, opened in a new tab when the frame is clicked.
stringthumbnail_urlstring
The preview image shown inside the video frame.
stringalt_textstring
A plain-text summary for screen readers.
stringtitlePlainTextElement
The video's title, shown below the description.
PlainTextElementtitle_url?string
Wraps the title in a link, opened in a new tab.
stringdescription?PlainTextElement
A line of text shown above the title.
PlainTextElementauthor_name?string
Shown in the byline, after the provider name.
stringprovider_name?string
Shown in bold in the byline, e.g. "YouTube".
stringprovider_icon_url?string
A small icon shown before the provider name in the byline.
stringblock_id?string
A unique identifier, up to 255 characters.
stringExamples
Full video block
The preview above sets every optional field: description, title_url, author_name,
provider_name, and provider_icon_url.
Minimal video block
VideoWithout provider_name or author_name, the byline row doesn’t render at all. Without
description, that line is skipped too, leaving only the thumbnail and title.