Skip to content

Creating an Embed

Embeds allow you to include interactive content from Spotify in any compatible website or web application. To set this up, you will need basic knowledge of HTML, or help from a webmaster or web developer.

  1. Open the Spotify Web Player.

  2. Find and open the content you want to embed. You can create an Embed for a podcast, episode, track, playlist, artist, or album. Eligible tracks can include a music video.

  3. Select the More options (...) button, select Share, then select the option beginning with Embed - for example, Embed track or Embed episode.

    The More options menu for a track, with Share expanded to show Copy link to Song and Embed track.

  4. Customize the Embed using the available colour and size options. For an eligible music-video track, confirm that the preview displays the video experience.

    The Embed track dialog displaying a music video preview and its customization options.

  5. Optional: select Show code to inspect the generated HTML.

    The Embed track dialog with Show code enabled, displaying the generated iframe HTML.

  6. Select Copy.

  7. Open your HTML editor and paste the code where you want the Embed to appear.

  8. Save and deploy your changes.

Choosing an Embed size

Set the iframe width to 100% to fill its container, and make the container at least 280 pixels wide for an audio Embed. The audio player has a minimum layout width of 280 pixels, so a narrower iframe can clip its content.

Choose a height that fits the amount of content you want to show:

HeightAudio layout
352 pixelsFull player, including longer lists such as albums and playlists.
232 pixelsLegacy landscape player; use 152 or 352 pixels for new placements.
152 pixelsCompact player for a track, episode, or show.
80 pixelsLegacy compact player with less information and fewer controls. Use 152 pixels for new compact placements when possible.

An eligible music-video track needs an iframe at least 250 pixels wide and 150 pixels high to show video. If either dimension is smaller, the Embed switches to the audio experience when available, or offers a link to open the track on Spotify. The generated video Embed uses 624 × 351 pixels by default.

These dimensions describe the player's layouts. The iFrame API does not reject smaller values, so check the rendered Embed at the actual size of its container.

Music video example

Music videos use the same Embed code as audio tracks. When a track has an eligible music video, Spotify presents the music video experience automatically. You do not need a different URL format or any additional query parameters.


_10
<iframe
_10
style="border-radius: 12px"
_10
src="https://open.spotify.com/embed/track/0Lr4kGOYn9l83EjuK6cZFQ"
_10
width="100%"
_10
height="352"
_10
frameborder="0"
_10
allowfullscreen=""
_10
allow="autoplay; clipboard-write; encrypted-media; fullscreen; picture-in-picture"
_10
loading="lazy"
_10
></iframe>

The track ID determines the embedded content. Spotify handles the available playback experience, including the music video, for the listener and their context.