Docs

Audio

A sound file with its own play button, seek bar and time.

On this page

The Audio widget plays a sound file from your media library, such as a voice sample, a podcast clip or a song, with a player drawn by your site: a round play button, a seek bar and the time. It is a light alternative to the browser's own player, styled to match your design, and works with the keyboard and screen readers.

Add an audio player

  1. Insert it

    Click Insert in the rail on the left, find Audio under Media (or type audio in Search widgets) and click it or drag it onto the canvas.

  2. Pick the file

    Click Audio file and choose or upload an MP3, M4A, OGG or WAV file in the media library.

  3. Name it

    Type a Title, such as "Booking call sample". Screen readers hear it with the play button; turn on Show title to show it next to the bar too.

  4. Choose the layout

    Button, bar and time shows the full player. Play button only shows just the round button, for example on a card or over an image.

Several players on one page don't talk over each other: with Pause other audio on (the default), starting one pauses the others, and a video with sound pauses the player (muted background videos keep playing).

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing).

Content tab

Audio
SettingWhat it does
Audio fileAn MP3, M4A, OGG or WAV file from the media library.
TitleWhat the recording is. Screen readers hear "Play" with it; shown next to the player when Show title is on.
Show titleShows the title above the bar. Not shown for Play button only.
LayoutButton, bar and time or Play button only. Default: Button, bar and time.
Show timeShows the current time and the length. On by default. Shown for Button, bar and time.
LoopStarts again from the beginning when the recording ends.
Pause other audioPlaying this one pauses any other audio or video playing with sound on the page, and a video started with sound pauses it. Muted background videos keep playing. On by default.

Design tab

Audio
SectionSettings
Play buttonSize and Icon size (Per device), Icon color, Background, Hover icon color, Hover background, Border radius (Per device), Border, Shadow.
Bar & timeSpacing and Bar height (Per device), Track color, Played color, Time typography, Time color, Title typography, Title color. Shown for Button, bar and time.
Shared Design sections

Every element also has these sections at the end of the Design tab.

SectionWhat it does
Spacing & positionMargin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position.
Background & borderBackground, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows.
MaskCrops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks.

Behaviour tab

Behaviour sections

The Behaviour tab is the same for every element.

SectionWhat it does
Anchor & classesAn Anchor ID for #links and your own CSS classes.
AnimationsEntrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects.
Motion & effectsA simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning.
Scroll & mouse effectsMovement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt).
VisibilityHide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility.
ConditionsShow the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions.
InteractionsShow, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions.
Attributes & CSSCustom HTML attributes and custom CSS for this element. See Custom CSS & attributes.

Tips

  • Keep files small. A spoken clip of a minute or two as a 64–96 kbps MP3 loads quickly and sounds clear.
  • A play button on a picture. Use Play button only and place it over an image with Position → Absolute for a voice-sample card.
  • Without JavaScript the browser's own player shows instead, so the recording always plays.