How to Add an Audio Player and Playlist to Joomla 5 and Joomla 6

Learn how to add audio to Joomla 5 and 6, when a simple HTML5 player is enough, and how to build a reusable playlist from your audio files.

Adding one audio file to a Joomla page is simple. Building a useful playlist with track titles, artists, artwork and repeatable management is a different problem.

This guide explains the practical options for Joomla 5 and Joomla 6, starting with a basic HTML5 player and moving to a reusable playlist module.

Option 1: Add a single HTML5 audio player

If you only need one audio file on one page, the browser's native HTML5 audio element may be enough.

<audio controls>
  <source src="/media/audio/example.mp3" type="audio/mpeg">
  Your browser does not support the audio element.
</audio>

You can place markup like this in content that allows HTML, for example a Custom module or an Article. Depending on your Joomla editor and text-filter configuration, some HTML elements may be cleaned or removed, so verify the saved output.

When a simple audio element becomes difficult to maintain

Manual HTML becomes repetitive when you have many tracks.

  • audio file URL;
  • track title;
  • artist;
  • album;
  • artwork;
  • duration;
  • ordering;
  • optional links or prices.

Organize your Joomla audio files first

images/audio/
    track-01.mp3
    track-02.mp3
    track-03.mp3

images/audio/covers/
    album-01.jpg
    album-02.jpg

You can upload files with your normal hosting workflow or Joomla Media Manager, depending on your site configuration and allowed file types.

Use metadata instead of retyping track information

MP3 files can contain ID3 metadata such as Title, Artist, Album and Year. A playlist module that reads this metadata can build much of the playlist automatically.

Create a Joomla module for reusable audio

  1. Open Content → Site Modules.
  2. Create or open the audio module.
  3. Select a template position.
  4. Set the module status to Published.
  5. Use Menu Assignment to choose which pages display the player.

Build a playlist from a folder with ES Audio Player

ES Audio Player is designed for Joomla audio collections where manually creating each track would be repetitive.

  1. Upload the audio files to a folder on your Joomla server.
  2. Optionally upload track or album images.
  3. Create an ES Audio Player module.
  4. Enter the relative path to the music folder.
  5. Enter the image-folder path if you use artwork.
  6. Let the module scan the folder and build the playlist.
  7. Review the detected metadata and override individual values where necessary.
  8. Publish the module and assign it to the required pages.

Use relative folder paths

images/audio

If the playlist is empty after scanning, the folder path is one of the first things to check.

Choose what track information to display

  • track title;
  • artist;
  • artwork;
  • duration;

For a music catalogue you may also want album, year, a follow-up link or price information.

Be careful with autoplay

Modern browsers may restrict autoplay with sound. Even when a Joomla audio module offers an autoplay option, browser policy can prevent playback until the visitor interacts with the page.

Make the player responsive

  • the player width does not exceed its container;
  • track titles can wrap;
  • controls remain usable on touch screens;
  • artwork scales without causing horizontal overflow;
  • the playlist remains readable at small widths.

Troubleshooting an empty playlist

  1. Check the music-folder path.
  2. Confirm that the files were uploaded to the expected directory.
  3. Confirm that the file format is supported by the player.
  4. Check that Joomla and the web server can read the directory and files.
  5. Save or trigger the folder scan after changing the path.

Frequently asked questions

Can Joomla play MP3 files without an extension?

Yes. A basic HTML5 <audio> element can play an MP3 file in a page or module where the markup is allowed. A dedicated extension is more useful when you need playlist management and track metadata.

Can I create a playlist automatically from a Joomla folder?

Yes, with a module that scans the selected server folder. ES Audio Player can read the folder and use available MP3 metadata to build the playlist.

Why does autoplay not always work?

Browsers commonly restrict autoplay with sound. The exact behavior depends on the browser, visitor settings and whether the visitor has interacted with the site.

Where should I upload the audio files?

Use a dedicated folder in a location your Joomla site and web server can read. Keep the structure simple and use the relative folder path expected by the module.

Summary

Use native HTML5 audio when you only need one simple track. When you have a growing library, use a Joomla module so the player can be assigned to the right pages and the playlist can be maintained separately from Article content.

For folder-based playlists, metadata and reusable module placement, see the ES Audio Player documentation.