Audio

Embed a simple audio player.

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

Last updated

April 20, 2024

Category: Media

For developers

View source on GitHub

Block Grammar & Markup

<!-- wp:core/audio {"align":"right"} -->
<figure class="wp-block-audio alignright">
    <audio controls="" src="data:audio/mpeg;base64,/+MYxAAAAANIAAAAAExBTUUzLjk4LjIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"></audio>
</figure>
<!-- /wp:core/audio -->

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

{
  "src": {
    "type": "string",
    "source": "attribute",
    "selector": "audio",
    "attribute": "src",
    "__experimentalRole": "content"
  },
  "caption": {
    "type": "rich-text",
    "source": "rich-text",
    "selector": "figcaption",
    "__experimentalRole": "content"
  },
  "id": {
    "type": "number",
    "__experimentalRole": "content"
  },
  "autoplay": {
    "type": "boolean",
    "source": "attribute",
    "selector": "audio",
    "attribute": "autoplay"
  },
  "loop": {
    "type": "boolean",
    "source": "attribute",
    "selector": "audio",
    "attribute": "loop"
  },
  "preload": {
    "type": "string",
    "source": "attribute",
    "selector": "audio",
    "attribute": "preload"
  }
}

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,
    "__experimentalDefaultControls": {
      "margin": false,
      "padding": false
    }
  },
  "interactivity": {
    "clientNavigation": 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:
Shortcodes.
Files.

View blocks per attribute or block support:

Block Attributes