audio_playlist Shortcode
The audio_playlist shortcode renders the audio playlist component.
The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.
Allowed child shortcodes: audio_item.
Usage
[audio_playlist]
Content
[/audio_playlist]Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
color_scheme |
— | dark |
Select default color scheme for the player. |
enable_bottom_controls |
yes |
yes |
If checked, player controls will appear sticked in the footer. |
hide_playlist |
— | yes |
If checked, playlist will be hidden and only playable with the footer controls. Available when enable_bottom_controls is yes. |
autoplay_playlist |
— | yes |
Request playback on arrival; browsers may require a click. The first eligible autoplay playlist wins. Requires footer controls. |
autohide_playlist |
— | yes |
Auto-hide footer controls until hover or keyboard focus; mobile visitors use the music button. Does not hide the page track list. Requires footer controls. |
device_visibility |
— | String unless stated otherwise | Applies the selected responsive visibility rule. |
el_id |
— | Valid unique HTML ID | Enter element ID (Note: make sure it is unique and valid according to w3c specification). |
el_class |
— | String unless stated otherwise | If you wish to style particular content element differently, then use this field to add a class name and then refer to it in your css file. |
Enclosed content
Content between the opening and closing tags is processed as WordPress shortcode content. Keep the parent/child structure shown by the visual builder so nested components receive the context they expect.
Customize the stylesheet
Administrators can replace the complete audio playlist stylesheet under Settings → POM Theme → Advanced → Custom CSS → Shortcode CSS assets → Audio playlist. Saving publishes an optimized per-site copy but does not add the stylesheet to pages that do not contain the shortcode. Reverting returns the existing web-audio-playlist handle to the current audio-playlist.min.css supplied by the theme. Playlist items, playback state, fixed controls, and the existing web_audio_playlist script remain unchanged.
The player remembers volume, mute, repeat, shuffle and a matching track position when browser storage is available. Only playlists and tracks supplied by the current page can be restored. With footer controls disabled, rows still support play/pause. Several playlists share one footer; Choose playlist in its playlist panel also exposes hidden lists. Device-hidden lists do not become the active player.
For the native editor workflow, see Build an Audio Playlist in Gutenberg. Legacy and native playlists can coexist.
Static HTML page caching is supported. Earlier cached playlist markup retains its footer autoplay and pin settings; current playlists use their own saved options.
Verification
Populate audio_playlist with audio_item and confirm every child remains reachable in the intended order. Pay particular attention to color_scheme and enable_bottom_controls.