Audio

<audio player. Single source URL plus controls/autoplay/loop/muted toggles.

<audio> player. Single source URL plus controls/autoplay/loop/muted toggles.

Key files

Props

PropTypeDefaultNotes
srcstringAudio file URL (required).
titlestringFor accessibility / tooltips.
controlsbooleantrueShow native controls.
autoPlaybooleanfalseBrowsers ignore autoplay without user interaction.
loopbooleanfalse
mutedbooleanfalse
preload"none" | "metadata" | "auto""metadata"
className, rootStandard.

When to use

  • Background music, podcast embeds, voice intros. For podcast embeds with platform branding (Spotify, SoundCloud), prefer Embed instead.
  • For video, use Video.

Gotchas

  • R2-hosted audio is fine — set src to the R2 delivery URL. The Media Manager handles R2 audio uploads (kind = "audio") but Audio component itself takes a plain URL.
  • Autoplay almost always requires muted: true in modern browsers.

Related