What Is a Playlist Embed?

Instead of pointing an embed at one video, YouTube also supports embedding a whole playlist. The player then shows the first video, along with next/previous controls that move through the rest of the playlist automatically.

How it’s built

A playlist embed uses the /embed/videoseries path together with a list parameter set to the playlist’s ID, rather than a single video ID. If you want to start on a specific video within the playlist, you can combine both a video ID and a list parameter.

When to use one

Playlist embeds work well for course-style content, multi-part tutorials, or a themed collection you want a visitor to move through without leaving your page. Toggle “Treat as playlist” in the embed code generator when your link includes a list= parameter.

How the player handles a playlist internally

A playlist embed does more than just queue videos one after another; the player maintains its own internal state, tracking which item is currently playing, exposing next/previous navigation, and (depending on settings) looping back to the start once the final video finishes. This is meaningfully different from embedding several single-video players stacked on a page, which would offer no shared navigation or continuity between them at all.

A practical example

A five-part video course could be embedded as a playlist so a visitor watches straight through without needing to click into a new page for each part:

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=0" title="Course playlist" allowfullscreen></iframe>

Changing index to 2 would start the embed on the third video instead of the first, useful if you want to link directly to a specific lesson while keeping the surrounding playlist queue available.

Playlist embed vs. individual video embeds

Whether to use a playlist embed or several individual embeds depends on how you want a visitor to move through the content. A playlist embed keeps everything in one player and one continuous viewing session, well suited to sequential content like a course or a multi-part tutorial. Individual embeds, placed separately on a page, give you more layout control and let a visitor jump straight to a specific video without waiting through a queue, better suited to a curated roundup where each video stands on its own. See our guide on how to embed a YouTube playlist for more detail.

Whichever approach you choose, the underlying video IDs and playlist IDs remain the same; only how they are arranged in the embed URL changes.

One subtlety worth noting: removing or reordering videos within a playlist on YouTube automatically updates every existing embed of that playlist across the web, since the embed always pulls the playlist’s current, live state rather than a fixed snapshot taken when the embed code was created.

Frequently asked questions