docs

Audio tracks

<mave-player> automatically surfaces an audio track selector whenever multiple audio tracks are available so viewers can switch between languages, commentaries, or descriptive audio. You can fine-tune when that selector appears, or force it on/off to match your UX needs.

Default behaviour

• If the underlying video exposes more than one audio track, the selector appears alongside the other controls.
• When only a single audio track exists, the selector stays hidden unless you explicitly force it to appear (useful when you plan to add a second track later).
• Tracks added via the dashboard receive permanent IDs, so they remain selectable across sessions.

audiotracks attribute

<mave-player
  embed="ubg50LeDE9v86ye"
  theme="dolphin"
  subtitles="en"
  audiotracks="off"
></mave-player>

Remove audiotracks="off" (or set it to "on") to let viewers switch between the available audio languages. You can use this attribute per embed, regardless of the defaults configured in the dashboard.

Controls integration

To show the selector, your controls list must include the audiotracks token (or fall back to the default full controls). Combine both knobs to match the UX you need:

<mave-player
  embed="ubg50LeDE9v86ye"
  controls="play time seek audiotracks volume fullscreen"
  audiotracks="on"
></mave-player>

The controls list governs whether the button is rendered, and the audiotracks attribute governs whether audio-track functionality is allowed.

Accessibility tips

• Pair the audio selector with clear labels (for example “English descriptive”, “Spanish”) so screen readers describe each option accurately. Labels inherit from the track metadata you configure in the dashboard.
• Use audiotracks="off" on embeds where alternate-language audio is not helpful (for instance silent explainers) so keyboard users don’t tab through extra controls unnecessarily.

Example

This sample embed contains multiple audio tracks so you can try the selector in action.