Skip to content
Block Kit for React
Esc
↑↓navigate↵open⌘Jpreview
On this page

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.

Your AppAPP
Slack is a new way to communicate with your team.
Video

Fields

PropType
typestring

Always video.

Typestring
video_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.

Typestring
thumbnail_urlstring

The preview image shown inside the video frame.

Typestring
alt_textstring

A plain-text summary for screen readers.

Typestring
titlePlainTextElement

The video's title, shown below the description. Less than 200 characters.

TypePlainTextElement
title_url?string

Wraps the title in a link, opened in a new tab.

Typestring
description?PlainTextElement

A line of text shown above the title. Less than 200 characters.

TypePlainTextElement
author_name?string

Shown in the byline, after the provider name. Less than 50 characters.

Typestring
provider_name?string

Shown in bold in the byline, e.g. "YouTube".

Typestring
provider_icon_url?string

A small icon shown before the provider name in the byline.

Typestring
block_id?string

A unique identifier, up to 255 characters.

Typestring

Examples

Full video block

The preview above sets every optional field: description, title_url, author_name, provider_name, and provider_icon_url.

Minimal video block

Your AppAPP
How to use Slack.
Video

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.

Last updated on