Using DISCO's embeddable player
DISCO lets you embed customizable players on your websites!
| NOTE: Activity (such as Streams, Downloads, and Page Views) from a DISCO embeddable player does not generate Stats. Stats are only collected from activity on Playlists you have shared using the Public playlist URL, the Email playlist directly method, or the Assign URL to a contact method. For more information on sharing Playlists and the specific Stats collected by each method, check out this article. |
How to embed a track or playlist
To embed a track or playlist, just open the Share menu for the track or playlist:
In the Share menu, select the Embed tab:
Supported files
In addition to tracks, you can also embed all the other file types DISCO supports: video, images, text documents, PDFs, and more.
Customizing your player
DISCO offers various options for customizing the look, size, and functionality of your player. To view the customization options, click Customize player in the bottom left of the tab:
This will show you the full range of customization options:
Enable downloads: lets you turn download links for tracks on or off. Please note downloads are only offered in embeds at the track, and not the playlist, level.
Enable artwork: lets you display or not display track artwork in the player.
Player size: lets you specify the size of the player. By default, the players are 480 pixels wide and 395 pixels high. Embeds must have a minimum width of 355 pixels wide and a minimum height of 285 pixels. If you enter amounts lower than this, you'll see those player size fields turn red, indicating those sizes aren't accepted:
Color theme lets you select between two color themes: white and dark. The color themes control the background of the player.
Advanced Customizations
There are several additional ways you can customize your embeddable player by simply editing a few values in the embed code. If you need help with this, please feel free to contact our Support team for help!
Control Colors lets you choose the color of the font and icons in the player, from four pre-set values.
If you'd like to use a different color outside of these presets, you can swap out the color in the embed code with the hex value of your desired color. In the example below, you would just replace the bolded characters with your hex value:
color=%2332B57C" Changing and removing the company/business information: You can customize the embeds so that they list other company names in the 'By' section, or list nothing under title and artist.
Below is an example embed code from a playlist with the company name changed. The bolded section is where it has been customized to include 'By My Company Name' instead of the default company name listed in your DISCO.
<iframe id="disco-playlist-3574336" name="disco-playlist-3574336" allowfullscreen frameborder="0" class="disco-embed" src="https://disco-xyz.disco.ac/e/p/3574336?download=true&by=By%20My%20Other%20Company&s=09mL5Jh6coNdqP4GyDieWYgBLz8%3AmeijTFRR&artwork=true&theme=white&color=%2332B57C" width="480" height="235"></iframe>On the embed, you'll be changing the highlighted text:
As in the above example, you'll need to include '%' for any spaces you wish to include.
You can also remove the whole 'By' line by inserting &by=%20 as below:
<iframe id="disco-playlist-3574336" name="disco-playlist-3574336" allowfullscreen frameborder="0" class="disco-embed" src="https://disco-xyz.disco.ac/e/t/26760149?download=true&by=%20&s=t01seZ0onoUvJj98cP684i1ib7o%3AoIF3Bziy&artwork=true&theme=white&color=%2332B57C" width="480" height="235"></iframe>
Or just remove 'By' by adding &by=Business as below:
<iframe id="disco-track-26760149" name="disco-track-26760149" allowfullscreen frameborder="0" class="disco-embed" src="https://disco-xyz.disco.ac/e/t/26760149?download=true&by=Business&s=t01seZ0onoUvJj98cP684i1ib7o%3AoIF3Bziy&artwork=true&theme=white&color=%2332B57C" width="480" height="235"></iframe>