Skip to main content

Interface: VideoBlock

Defined in: block-kit/blocks.ts:329

Description​

Displays an embedded video player. A video block is designed to embed videos in all app surfaces (e.g. link unfurls, messages, modals, App Home) — anywhere you can put blocks! To use the video block within your app, you must have the `links.embed:write` scope.

See​

Video block reference.

Extends​

Properties​

alt_text​

alt_text: string;

Defined in: block-kit/blocks.ts:347

Description​

A tooltip for the video. Required for accessibility.

author_name?​

optional author_name: string;

Defined in: block-kit/blocks.ts:360

Description​

Author name to be displayed. Must be less than 50 characters.

block_id?​

optional block_id: string;

Defined in: block-kit/blocks.ts:39

Description​

A string acting as a unique identifier for a block. If not specified, a block_id will be generated. You can use this block_id when you receive an interaction payload to identify the source of the action. Maximum length for this field is 255 characters. block_id should be unique for each message and each iteration of a message. If a message is updated, use a new block_id.

Inherited from​

Block.block_id

description?​

optional description: PlainTextElement;

Defined in: block-kit/blocks.ts:372

Description​

Description for video using a PlainTextElement object.

provider_icon_url?​

optional provider_icon_url: string;

Defined in: block-kit/blocks.ts:368

Description​

Icon for the video provider, e.g. YouTube icon.

provider_name?​

optional provider_name: string;

Defined in: block-kit/blocks.ts:364

Description​

The originating application or domain of the video, e.g. YouTube.

thumbnail_url​

thumbnail_url: string;

Defined in: block-kit/blocks.ts:343

Description​

The thumbnail image URL.

title​

title: PlainTextElement;

Defined in: block-kit/blocks.ts:351

Description​

Video title as a PlainTextElement object. text within must be less than 200 characters.

title_url?​

optional title_url: string;

Defined in: block-kit/blocks.ts:356

Description​

Hyperlink for the title text. Must correspond to the non-embeddable URL for the video. Must go to an HTTPS URL.

type​

type: "video";

Defined in: block-kit/blocks.ts:333

Description​

The type of block. For a video block, type is always video.

Overrides​

Block.type

video_url​

video_url: string;

Defined in: block-kit/blocks.ts:339

Description​

The URL to be embedded. Must match any existing unfurl domains within the app and point to a HTTPS URL.