WavePlayer settings – located at the Settings –> WavePlayer page of the WordPress Admin area – define how to display a shortcode with no parameters provided other than the IDs of the audio tracks you want to included in that particular instance of the player, like the following one:

[ waveplayer ids="101,102,103" ]

Please note that changing any of these settings will affect the way each instance with ANY missing parameter will be displayed on your website.

Buy WavePlayer now, only on

Default player options


In the first panel of the WavePlayer Settings you can define the default options for the size, style, shape, autoplay, repeat_all and shuffle parameters. Whenever you insert an instance of the Waveplayer without providing any of these parameters, the instance will be displayed according to these settings.

In this panel you can also select an image that WavePlayer will use as a thumbnail for the tracks that have no featured image. Simply click on the preview of the current default image and a Media dialog will open, allowing you to select or upload your desired image.

Buy WavePlayer now, only on

Default waveform options and color scheme


In the second panel of the WavePlayer Settings you can set all the default values that define how the waveform is going to be rendered. Whenever you insert an instance of the Waveplayer without providing any of these parameters in the shortcode, the instance will be displayed according to these settings.

Through these options you can have the waveform perfectly matching your current WordPress theme and thanks to the realtime preview, you can see the result of your changes without even the need to save the settings.

Furthermore, all these settings can be added as parameters to each Waveplayer shortcode, customizing each instance of the player, regardless of these default settings.

Buy WavePlayer now, only on

HTML & CSS Customization


In the last panel you will find two different sections.

The first one, HTML Customization, allows you to customize the information shown in the info bar and the playlist of each player instance. You can use pretty much every ID3 tag you know are saved in the audio file you uploaded. Simply write you HTML template including each tag surrounded by a “%” character. For example, if you want to show the title of the song followed by the artist name, you can write the following HTML code in the textarea:

%title% by %artist%

Additionally, you can use other special placeholders to show buttons, icons and statistics regarding the track. For example, to show the “title” of a track, a “cart” button, a “like” button with likes count and a “play count”, you can use the following codes:

%title% %cart% %likes%

For a comprehensive list of the available placeholders, please refer to the page “How to customize the info bar and the playlist rows”.

The second section, CSS & Javascript Customization, allows you to add your own CSS rules and Javascript code to the player. Your custom CSS rules can be useful to customize the default WavePlayer’s CSS rules or create your own set of rules to be added in the info bar template. Your custom Javascript code allows your website to interact with the player. For example, if your theme uses AJAX to load the content of the page, you need to manually initialize WavePlayer once the AJAX loading has completed.

For a detailed guide on how to use the Javascript code, please refer to the page “How to use your custom Javascript code”.

Buy WavePlayer now, only on



A peak file is saved by WavePlayer in the ‘peaks‘ subfolder of the plugin, whenever an audio track is loaded for the first time. This allows WavePlayer to render the waveform of each audio file much faster the following times.

If you delete an audio track that was previously used in WavePlayer, the peak file remains unused forever in the peak subfolder of the plugin. Although peak files are very small in size (usually around 30 kB), it can be a waste of your hosting space if you happen to upload and delete audio attachments regularly. It is recommended to delete orphan peak files clicking on the Delete orphan peak files button every time you delete a massive amount of audio attachments from your website.

If, for any reason, you want to make sure WavePlayer regenerates all the peak files, you have to delete them using the Delete all peak files button.

Buy WavePlayer now, only on

WooCommerce Integration


This page is divided into two sections. In the top one, you can select all the options regarding how WavePlayer will incorporate an instance of the player to your products, in both the Shop and Product pages.

The bottom one allows you to batch create products for the audio files you have already in your Media Library. You can create products for two different entities: singles and albums. When you upload a collection of audio files to the Media Library, WordPress extracts the information regarding each file from the ID3 tags. One of this information is the album of the track. If that information is present, WavePlayer will list all the albums your audio files belong to. When you create a product for an album, WavePlayer will automatically create a WooCommerce product with all the audio files belonging to that album listed as preview files.

Both batch processes create drafts of simple virtual downloadable products. Once the process has completed, you can review each product, adding the necessary downloadable files, and publish it.