File

Add a link to a downloadable file.

This block is available in the latest version of WordPress and does not require the Gutenberg plugin.

Last updated

Category:

For developers

Block Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

{
  "id": {
    "type": "number"
  },
  "href": {
    "type": "string"
  },
  "fileId": {
    "type": "string",
    "source": "attribute",
    "selector": "a:not([download])",
    "attribute": "id"
  },
  "fileName": {
    "type": "rich-text",
    "source": "rich-text",
    "selector": "a:not([download])"
  },
  "textLinkHref": {
    "type": "string",
    "source": "attribute",
    "selector": "a:not([download])",
    "attribute": "href"
  },
  "textLinkTarget": {
    "type": "string",
    "source": "attribute",
    "selector": "a:not([download])",
    "attribute": "target"
  },
  "showDownloadButton": {
    "type": "boolean",
    "default": true
  },
  "downloadButtonText": {
    "type": "rich-text",
    "source": "rich-text",
    "selector": "a[download]"
  },
  "displayPreview": {
    "type": "boolean"
  },
  "previewHeight": {
    "type": "number",
    "default": 600
  }
}

Block Supports

Optional. Type: Object.

A set of options that enables or disables block controls in the editor, for example gradient colors or padding.

Documentation

{
  "anchor": true,
  "align": true,
  "spacing": {
    "margin": true,
    "padding": true
  },
  "color": {
    "gradients": true,
    "link": true,
    "text": false,
    "__experimentalDefaultControls": {
      "background": true,
      "link": true
    }
  },
  "interactivity": true
}

Transforms

Optional. Type: Object.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms from: Audio. Video. Image.
Files.

Transforms to: Audio. Video. Image.


View blocks per attribute or block support: