Skip to content

Getting started

Minimal audio player embed with default controls.

audio

Preview

Props & interactive options

Prop Type Default Description Try it
auto_play url param off Start playback automatically.
muted url param off Start muted.
loop url param off Loop playback.
Browsers block autoplay with sound. Enabling auto_play automatically enables muted so playback can start; viewers can then unmute manually.

Documentation

The simplest audio player setup: play/pause, time display, volume control, and a progress bar. Configure autoplay, muted start, and preload strategy.

Code

HTML

Frequently asked questions

The audio player posts a videas:embed:resize message to the parent window whenever its content grows or shrinks (playlist expansion, subtitle cues, chapter panel…). The snippet above includes the small listener that resizes the iframe — drop it on your page once and the embed stays pixel-perfect.

Same rules as for video: muted=1 combined with auto_play=1 is the only combination guaranteed to start without user interaction on iOS Safari and Chrome Android. Unmuted autoplay requires a previous tap somewhere on the page.

No. Audio is streamed progressively: the browser fetches only the portion needed to keep playback buffered, and continues as the viewer listens. Large files don't block the page load.