Video block
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. The
thumbnail sits in Slack’s 360 × 283 frame, which narrows with its shape kept when the message is
narrower, as on a phone. The title and description wrap at the message’s width, not the frame’s.
Fields
typestring
Always video.
stringvideo_urlstring
An embeddable video URL, opened in a new tab when the frame is clicked. Slack requires HTTPS, a domain in your app's unfurl domains (not a Slack domain), and the links.embed:write scope.
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. Less than 200 characters.
PlainTextElementtitle_url?string
Wraps the title in a link, opened in a new tab.
stringdescription?PlainTextElement
A line of text shown above the title. Less than 200 characters.
PlainTextElementauthor_name?string
Shown in the byline, after the provider name. Less than 50 characters.
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
Without 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.
See Limits for every block’s field lengths.