CloudRadio includes a free, embeddable web player that works with any hosted radio, AutoDJ station, or external HTTPS audio stream. All 16 player designs are free for every broadcaster.
Create a Player
From your station sidebar
The quickest way to create a player is from your radio or station detail page:
- Open your radio or station
- Click Players in the sidebar
- Click New player
The stream source is pre-selected automatically. If your radio has multiple mount points, you'll be asked to pick one. Otherwise, you go straight to naming your player and confirming.
From the Players Page
You can also create players from the main Players page:
- Go to Players from the main navigation
- Click New player
- Choose a stream source type:
- My Radio: select one of your CloudRadio hosted radios
- AutoDJ HLS: select one of your CloudRadio One stations (only shown if you have AutoDJ stations)
- External Stream: enter the URL of any publicly accessible Icecast or Shoutcast stream (HTTPS required)
- Select the specific radio, station, or enter the URL
- Name your player and click Create player
You can create multiple players for the same stream source. This is useful if you want different designs for different pages on your site.
Customize
After creating a player, the editor opens on the Customize tab, with a live preview next to the options. Changes show in the preview right away. Click Publish changes to make them live on your website; until you do, your embed keeps the last published version.
Layouts
Choose from 16 player designs in the Layout section. All of them are free.
| Layout | What it looks like |
|---|---|
| Aura | The cover over a slow, swirling glow made from its own colors |
| Island | A black pill that opens for a few seconds on every new song |
| Ticker | A thin full-width bar with the song scrolling across it |
| Orbit | The cover in a circle, ringed by level bars in your player color |
| Dot matrix | The song on an LED sign in your player color |
| Instant | Every new song comes out as an instant photo with a handwritten title |
| Stack | The current cover on top of the covers of the songs before it |
| Full-bleed | The cover fills the player, with the song and play button over it |
| Color-matched | Takes its color from the current cover, changing with every song |
| Setlist | The song playing now, with the songs before it and when they aired |
| Box | A card with large cover art |
| Bar | A horizontal bar for headers, footers, and page banners |
| Mini | A small compact player |
| Vinyl | A spinning vinyl record |
| Cassette | A retro cassette tape |
| Cyber | A neon-styled player |
Click a layout to switch. The preview updates instantly, and the Embed tab shows the recommended size for the layout you picked.
Setlist and Stack show song history. For an external stream, the history fills in as songs change, so it can be short right after you set up the player.
On AutoDJ stations, every new design except Dot matrix shows a Live badge while a DJ is on air. During a scheduled Live DJ event, Orbit, Aura, Island, Full-bleed and Setlist add the show's name to the badge: the event's Custom name, or the DJ's name when it has none.
Bars that follow the music
Aura, Orbit, Island, Ticker, Dot matrix, Setlist and Cyber show level bars or a wave while the player is playing.
- AutoDJ stations: the bars move with the song that is playing, in most browsers.
- Other streams (hosted Icecast stations and external streams), and Safari on some devices: the bars play a steady animation that is not tied to the sound.
Nothing needs to be turned on, and the player works the same either way. When a visitor's device asks for reduced motion, the bars stay still.
Player color
Set your player's primary color to match your brand. Text colors are auto-optimized for contrast.
The Cyber layout uses color presets instead of a free color picker: Arc Cyan, Hyper Pink, Neon Lime, or Pulse Violet.
Card style
Setlist and Stack offer three Card style options: Light, Dark (for dark websites), and Station color (the card takes your player color).
Listener count
Setlist, Stack, Aura and Island can show how many people are listening. Turn on Show listener count to enable it. The count is hidden when it is unknown or zero, and it needs a CloudRadio station or radio as the source.
CloudRadio badge
Every player design shows a small CloudRadio badge. Turn on Hide CloudRadio badge to show only your station's brand in the player. It is free, and you can turn it back on at any time.
The option is available for players on a CloudRadio hosted radio or AutoDJ station. Players on an external stream always show the badge, so the option is grayed out for them.
The badge on your station page has its own checkbox in the station page settings.
Station logo
Six designs show your station's logo next to its name: Setlist, Stack, Color-matched, Full-bleed, Orbit and Island. In Island the logo appears when the player is expanded. There is no setting for it: when your station or radio has a logo, these designs show it. When it doesn't, they look the same as before.
The logo is the one you upload in Profile & Branding, on the Look & feel tab, under Logo (available on CloudRadio One). The player shows it small, about 20 to 30 pixels tall, so a simple square mark reads best. A wide logo keeps its proportions, within a maximum width.
The other designs don't show the logo. Those with cover art, such as Aura, Box and Instant, show your Fallback cover when a song has no artwork (see Default cover art). Players on an external stream have no station logo, so they never show one.
On the dark parts of Island, Orbit and Full-bleed, a logo with a transparent background and dark colors can be hard to see. If yours disappears, upload a version with a solid or light background.
Typography
Select a font style for your player:
| Font | Style |
|---|---|
| Modern | Clean system fonts |
| Serif | Classic book-style |
| Monospace | Technical look |
| Humanist | Friendly and warm |
| Display | Bold geometric headline |
| Broadcast | Tall condensed caps |
| Rounded | Soft rounded shapes |
| Editorial | Elegant high-contrast serif |
The first four are free. Display, Broadcast, Rounded and Editorial (marked with a lock) are included with CloudRadio One. You can preview them on any player, but only a CloudRadio One player can publish them.
Dot matrix, Instant, Cassette and Cyber use fixed typography.
Default cover art
The Fallback cover from Profile & Branding is displayed when no track artwork is available from the stream.
Click Edit next to the cover in the editor to choose between:
- Inherit ... Branding Kit (recommended): uses the cover from your station's or radio's Profile & Branding settings. The option names the station it inherits from.
- Use preset: select a built-in cover, or upload your own.
External stream players use a preset or uploaded cover.
When your stream provides track metadata, CloudRadio automatically fetches and displays matching album art. The Fallback cover only appears when no match is found.
Playback
Autoplay starts playing as soon as the player loads. Most modern browsers block unmuted autoplay by default (see the troubleshooting section below for details), so a play button may appear instead.
Autoplay is disabled by default in CloudRadio players, and leaving it off is the better choice in most cases:
- Forcing audio on visitors is a common reason people close a tab, especially on mobile or limited data plans.
- Modern browsers (Chrome, Safari, Firefox, iOS) block unmuted autoplay anyway, so enabling it often does nothing.
- Enable autoplay only when the listener has clearly expressed intent, for example a popup player opened from a "Listen Now" button, or a dedicated "/listen" landing page.
Default volume sets the initial volume level (0 to 100%). Listeners can adjust the volume after the player loads, and their preference is saved in the browser for future visits.
Embed on Your Website
Open the Embed tab in the player editor to get ready-to-copy code for your website.
Iframe
The iframe embed places the player directly in your page. Copy the code from the Embed code (iframe) section and paste it into your HTML. The code includes your player's URL and the correct dimensions for your selected layout.
Example of what the generated code looks like:
<iframe
src="https://embed.clrd.net/player/your-player-id"
width="320"
height="502"
frameborder="0"
allow="autoplay; encrypted-media"
title="Radio Player"
></iframe>
The width and height values match your selected layout, as listed under Recommended dimensions. Bar, Ticker and Dot matrix use width="100%" and stretch to the width of their container.
Popup Button
The popup button opens your player in a centered browser window, keeping it separate from your page layout.
Copy the code from the Popup player button section. You can change the button text and style it with your own CSS. Use the Test Popup button in the editor to preview the result.
Troubleshooting
Player shows "Connection failed"
Check that your stream source is online. For external streams, confirm the URL is publicly accessible and uses HTTPS.
Autoplay doesn't work
Most browsers block unmuted audio autoplay by default. When autoplay is blocked, the player shows a play button for the listener to start manually. This is a browser-level policy that websites cannot override.
| Browser | Policy |
|---|---|
| Safari 11+ | Blocks all unmuted audio autoplay. |
| Chrome 66+ | Blocks unmuted autoplay unless the user has previously interacted with the domain (click, tap, etc.). |
| iOS (all browsers) | Blocks all audio autoplay. |
| Firefox | Blocks unmuted audio autoplay by default. |
More browsers are adopting similar policies over time. In general, autoplay with sound is considered an unwanted practice on the web. Design your site so that listeners click play to start the stream.
Player looks too large or small
Make sure your iframe dimensions match the Recommended dimensions shown on the Embed tab for your layout. For a full-width player, use Bar, Ticker, or Dot matrix with width="100%".