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

File

A card referencing a file shared by a remote storage provider.

file renders a reference to a file, currently only source: "remote", a file registered by an app through Slack’s files.remote APIs (e.g. a Google Drive or Dropbox document). Use it to show a linked document Slack knows about without embedding its contents.

Your AppAPP
F0123456789remote file

Fields

PropType
typestring

Always `file`.

Typestring
external_idstring

The id the registering app assigned the file when it called `files.remote.add`.

Typestring
sourcestring

The file's source. Slack currently only documents `"remote"`.

Typestring
Default"remote"
block_id?string

A unique identifier, up to 255 characters.

Typestring

Examples

Remote file reference

Your AppAPP
F0123456789remote file

Outside a real Slack workspace, only the fields present in the JSON are available, so the card shows the external_id in place of the file’s actual name. There’s no way to look up the real filename, type icon, or thumbnail without calling back into the registering app.

Was this page helpful?