Audio Block
Embed audio content with a styled player. Upload audio files directly or link to external URLs. Display track title and artist information alongside standard playback controls.
The Audio block provides a styled audio player for embedding sound content in your documentation. Upload audio files directly or reference external URLs, with optional track metadata displayed alongside the player.
When to Use
Block Properties
| Property | Required | Description |
|---|---|---|
| Source Mode | Yes | Toggle between Upload File or External URL |
| Audio File / URL | Yes | The audio source (upload or URL) |
| Title | No | Track or episode title displayed above the player |
| Artist | No | Speaker, creator, or artist name displayed below the title |
Supported Formats
| Format | Browser Support | Use Case |
|---|---|---|
| MP3 | Universal | Best balance of quality and file size |
| WAV | Universal | Uncompressed, large files |
| OGG | Most browsers | Open format alternative |
| M4A | Most browsers | Apple ecosystem |
| FLAC | Most browsers | Lossless compression |
| AAC | Most browsers | Efficient compression |
Player Controls
Example: External URL Audio
An audio player using an external URL: