File

Name: core/file
Category: <a href="https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-media/">media
API Version: <a href="https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/">3
Block Type: <a href="https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/">Hybrid (static save + server enhancements)
Keywords: document , pdf , download

Add a link to a downloadable file.

Attributes

Defined via the attributes property in block.json.

Attribute	Type	Default	Description
`id`	`number`	—	—
`blob`	`string`	—	Role: `local`
`href`	`string`	—	Role: `content`
`fileId`	`string`	—	Source: `attribute`. Selector: `a:not([download])`. HTML attr: `id`
`fileName`	`rich-text`	—	Source: `rich-text`. Selector: `a:not([download])`. Role: `content`
`textLinkHref`	`string`	—	Source: `attribute`. Selector: `a:not([download])`. HTML attr: `href`. Role: `content`
`textLinkTarget`	`string`	—	Source: `attribute`. Selector: `a:not([download])`. HTML attr: `target`
`showDownloadButton`	`boolean`	`true`	—
`downloadButtonText`	`rich-text`	—	Source: `rich-text`. Selector: `a[download]`. Role: `content`
`displayPreview`	`boolean`	—	—
`previewHeight`	`number`	`600`	—

Defined via the supports property in block.json.

This is a hybrid block. It saves static markup that the server may enhance during rendering.

<!-- wp:file {"showDownloadButton":true,"previewHeight":600} -->
<!-- Content... -->
<!-- /wp:file -->