Before you start
- A working HTTPS stream and a saved player configuration.
- A WordPress account with permission to install the plugin or embed the required scripts.
Set it up in three steps
Create and preview your player
Connect your stream and choose a player design in Web Radio Players. At the completed setup screen, select the WordPress option and copy your player ID.
Install the official plugin
Download the plugin from the dashboard and activate it in WordPress. Open its settings, enter your player ID, preview it, and save. Add the supplied shortcode where you want the player to appear.
Publish and check your page
Open the published page outside the editor and press Play. Check it on mobile. If you enable the plugin’s sticky option, choose a horizontal player and check that it leaves your page controls accessible.
Prefer a Custom HTML block?
Copy the complete generated embed into a Custom HTML block, then preview and publish. Your WordPress plan, permissions, theme, and security tools must allow the required scripts. If they remove the scripts, use the plugin where installation is available.
Understand playback between pages
A normal WordPress page reload stops an embedded player, including a sticky one. Use the documented popup method when you want a separate listening window that can stay open while visitors browse. The listener must open that window.
Keep your content in WordPress
Posts, pages, and your theme stay in WordPress. The dashboard controls your saved player. A hosted station page is configured separately and includes its own independent player.
Check before sharing
- Press Play on the published page, then test on a phone as well as a desktop. Browsers generally require a listener action before starting audio.
- If the player is missing, check the saved player ID, required scripts, and any caching or script optimisation tools.
- If you enabled domain restrictions, include the hostname of the published WordPress site. A preview or staging hostname may need its own entry.
Step-by-step documentation
Follow the full walkthrough
Need help with your setup? Contact support.
