The Radio.co Requests feature allows you to provide interactivity on your station. Listeners can choose from a list of tracks you specify to be played on any of your playlists automatically. The more popular a track request is, the sooner it will play!
This feature is available on the Standard, Plus and Premium Station plans. We recommend completing each setup stage in the order listed in this guide.
Request Settings & Allowing Listener Requests
Firstly, you will need to allow listeners to request a song. This can be done in the configurations settings found in the 'Requests' tab.
Click on 'Config' to enter the configuration settings.
Enable Track Requests - Turn on the setting to allow listeners to request a track.
Tag Policy - You can block certain tags to prevent listeners from selecting a specific song, or you can Allow listeners to only select songs from a specific tag. Please specify the tags in the box below once you have confirmed which option you want.
Requests Per Slot / Slot Length - Specify how many requests a listener is allowed to have within a certain time frame.
Daily Limit Per Listener- Here you can limit how many requests a listener is allowed per day.
Expiry - This is the length of time a track request remains in the queue until it's removed if it was not played.
Making a Request Widget
To create a widget you can embed on your website, navigate to Requests". This can be placed on most website builders. Please refer to your Website providers guide on how to embed javascript.
In your Dashboard, head to Requests > Widgets.
Click the green Create Widget button and give the widget a pet name.
The widget editor will load. You can see a preview of how your request widget will look on the right-hand side.
Settings:
Name - rename your widget. This is a pet name so you can identify it on your Radio.co dashboard.
Size - Choose a predefined size or custom from the drop down.
Background, Text, Button - Specify the colour used for each section using the colour picker. Corners - Choose either rounded or square corners.
Corner Style - Specify how the Widget box will look. Choose from Square or Rounded.
Background Style - To fill the widget background with your album art choose Cover Art. Choose colour for the background to remain as a solid colour.
Button Style - Choose from square or round buttons.
List Artwork - Display artwork in your widget's search list.
Confirmation Text - Customise the text shown when a listener has requested a track.
Click Save Changes at the bottom of the page to save your widget. You can embed the widget on your site by clicking 'Copy Embed' shown at the top of the widget editor.
Playing Requests
Requests can be played out in any of your playlists. To do this you will need to add the special Request Tag to your playlists.
You can find this under Tags in your Playlist editor. The tag will select the most requested song by default. If the request queue is empty, the request tag will be discarded and the playlist will advance to the next position.
Request Management
Head to Requests > Active Requests to load your current requests list.
Here you can add the request, see how many votes each track has had and remove tracks from the queue.
Note: Requests uses a voting priority system. If a track gets more votes it will move up the queue and play sooner.
If you wish to clear requests, click trash can icon in the Remove column:
