• Login
  • Plugins
  • API
  • SDKs
    • SDK web
    • Javascript
  • Guidelines
  • Introduction
  • Plugins
  • Widget Player

Deezer Player Widget

Embed a Deezer player in your website to share your favorite music

Create your widget


1. Pick the Deezer music you want to play in your website:

  • Playlist
  • Album
  • Tracks
  • Podcast
  • Episodes
  • Mix
  • Artist
  • Charts
  • Playlist ID:
  • Search album:
      DISPLAY
    Album ID:
  • Tracks ID:
  • Podcast ID:
  • Episodes ID:
  • Mix:
  • Search artist
      DISPLAY
    Artist ID:
  • Chart:

2. Choose your options:

  • If you need some reporting & tracking, create a new application to have a complete resume of your audience.

    Format
    Classic

    Square
    Size
    Width px

    Height px

    The widget is responsive, these values will be updated according to the size of the container
    Custom

    Hexa color

    Theme

3. Get the code:

Copy and paste this code on your website

  • IFRAME
  • HTML5

FAQ

30 seconds or Full tracks: what are the rules?

You can refer to our content access rules below. Users have be to logged in with Deezer to benefit from music on demand.

Desktop Device Unlogged users Freemium users Premium users
Mixes Full Track / unlimited Full Track / unlimited Full Track / unlimited
Music on Demand 30s. extract Full Track / Ads Full Track / Unlimited
Mobile Device Unlogged users Freemium users Premium users
Mixes 30s. extract 30s. extract 30s. extract
Music on Demand 30s. extract 30s. extract 30s. extract

Due to legal restrictions on mobile, only 30 seconds previews can be provided.


What’s the difference between a playlist and a mix ?

Playlists and mixes are both sets of tracks you can listen to thanks to the Deezer player. Mixes have to comply with DMCA rules:

  • 6 track skips per hour (skips = pressing the next button to change the current track),
  • no interaction = no change in the track order,
  • limited number of tracks from a same artist, etc.
As in real life, you don’t choose what’s on a mix at a specific time.
On the contrary, you can listen to the tracks you want with a playlist, in the order you like.
However, since rights management rules do not apply the same way on playlists and Mixes, users have to be logged in as Deezer Premium users to be able to listen to full-tracks in a playlist. If not, they’ll be limited to 30 seconds previews.


Is there a way to provide full-track access to my playlist without prompting users to log in?

No. The only way to have full-track access for anyone is to use a radio.


To create a playlist, you can:

  • use the Deezer API. With the API, you can programmatically create, update (or rename), reorder, add/remove tracks to a playlist (http://developers.deezer.com/api/actions-post)
  • do it manually on www.deezer.com.


What are the different layout types?

The widget is responsive, it adapts to the container it belongs to. Depending on the space available, there are three options:

Layout Default Sizes Dimensions Settings
square small 80 pixels No waveform, no playlist available
medium from 200 pixels to 400 pixels No waveform
big from 400 pixels to the size of the container
classic small from 200 pixels to 350 pixels No waveform
medium from 350 pixels to the size of the container


Settings

In addition to the settings above, you can also change the following:

Setting Description Default
playlist Displays the playlist or not. Can be either "true" or "false". false
width The width of the widget 600
height The height of the widget 200
autoplay Plays automatically the music after loading. Can be either "true" or "false". false
type The type of music you want to play. Can be "playlist", "album", "tracks", "charts or "favorites". playlist
format The layout format of the widget. Can be either "square" or "classic". classic
size The layout size of the widget. Can be "small", "medium" or "big" according to the format and the size. medium
layout The general layout of the widget. Can be either "light" or "dark". light
app_id Your app ID if you want some reporting & tracking 1
color The general color of the widget. Has to be a hexadecimal value without the # EF5466
emptyPlayer Displays or not the widget. Can be either "true" or "false". false

Back to top

Follow @deezer

Terms of use
Contact & Support