Audio

Use Audio to add a single audio player or playlist from the WordPress Media Library or a direct audio file URL.

Usage

Use Audio to render a WordPress audio player from either files in the WordPress Media Library or a direct URL to a single audio file. Depending on how the source is configured, the module outputs either one audio player with standard playback controls or a playlist player with optional track display settings.

Use Audio for podcasts, music tracks, interviews, sermons, voice recordings, and other layouts where visitors need inline playback without custom code. The module renders WordPress's native [audio] and [playlist] shortcodes, so the Media Library option fits audio managed in WordPress, while the Link option works when you already host a single audio file elsewhere and have its direct file URL.

Module Settings

The Audio module settings control where audio comes from and how a single player or playlist behaves on the front end.

General Tab

The General tab sets the audio source and reveals playback settings based on whether the module is rendering one file or a playlist.

Audio Type

Selects whether the module uses the WordPress Media Library or a direct audio file URL.

• Media Library: Builds the player from audio files selected in the WordPress Media Library. Supports single-file playback and playlists when more than one file is selected.
• Link: Builds the player from a direct URL to a single hosted audio file.

Media Library

Audio

Selects one or more audio files from the WordPress Media Library. This custom field shows the current number of selected files and includes controls to Select Audio, Edit Playlist, or Add Audio Files. When one file is selected, the single-audio playback settings below apply. When more than one file is selected, playlist settings become available.

Playlist

Style Default: Light

Sets the playlist appearance to a light or dark preset when more than one audio file is selected.

Show Playlist Default: Yes

Shows or hides the playlist track list beneath the player when more than one audio file is selected.

Show Track Numbers

Show Track Numbers (Show Playlist Only) Default: Yes

Shows or hides track numbers in the playlist when Show Playlist is set to Yes.

Show Thumbnail Default: Yes

Shows or hides playlist thumbnail images when they are available for the selected audio files.

Show Artist Name Default: Yes

Shows or hides artist metadata in the playlist when it is available for the selected audio files.

Link

Link Supports: Field Connections

Sets the direct URL to a single audio file when Audio Type is set to Link. The module passes this value directly to the WordPress audio shortcode to render the player.

Because this field is used as the player source URL, use a direct file link such as https://example.com/audio/episode-01.mp3 rather than a page URL or third-party embed page.

Single Audio Playback

Auto Play (Single Audio Only) Default: No

Automatically starts playback when the module is rendering one audio file, whether that file comes from the Media Library or the Link option.

Loop (Single Audio Only) Default: No

Repeats the current audio file after it finishes when the module is rendering one audio file.

Advanced tab

The Advanced tab includes all the standard settings for margins, visibility, animations, and advanced HTML configurations.

See the Advanced tab section for more information.

Create a playlist

To build a playlist in the Audio module, follow these steps:

Step

Open the Audio module settings.

Step

Set Audio Type to Media Library.

Step

In the Audio field, click Add Audio Files or Select Audio to open the WordPress Media Library.

Step

Choose multiple audio files, then create or insert the playlist from the Media Library modal.

Step

Return to the module settings and adjust playlist options such as Style, Show Playlist, Show Thumbnail, and Show Artist Name as needed.

Once more than one file is selected, the module switches from single-audio playback to playlist mode and reveals the playlist display settings.

Supported audio formats

The Audio module is built on the native WordPress audio and playlist shortcodes, which determine the file types it can accept. The module supports the following audio formats:

• .mp3
• .m4a
• .ogg
• .wav