Playlist layouts

Playlist layouts control how the player and item list appear together on the page. Choose the layout based on the content type, page width, and how often viewers need to browse the list while watching or listening.

Video playlist layouts

Video playlists show a primary player plus a list of playlist items. Use the layout controls in the Playlist Editor or playlist block inspector to choose how the list is placed.

Common layout decisions:

Setting	Best use
List below the player	Default article, course, and landing page embeds where the video should stay full width.
List above the player	Pages where viewers should choose an item before watching.
Side list	Wider pages where viewers should browse episodes while the current video remains visible.
Compact or collapsed list	Dense pages, sidebars, or smaller placements where the list should not dominate the player.

Use a side layout only when the content area is wide enough. On narrow screens, the layout should stack so the video remains readable and the list stays usable.

Audio playlist layouts

Audio playlists are optimized around a track list and audio controls. They work well for albums, podcasts, sermons, lessons, guided audio, and downloadable audio libraries.

Common audio layout decisions:

Setting	Best use
Track list below controls	Standard listening pages where playback controls should appear first.
Track list above controls	Archive pages where choosing a track is the primary action.
Compact list	Sidebars, lesson pages, and dense resource areas.

Keep audio titles short enough for mobile screens. If your audio titles are long, use clear episode numbers or module prefixes so viewers can scan the list quickly.

Layout checklist

Before publishing a playlist, check:

• The first item is the intended default item.
• The list order matches the expected viewing or listening sequence.
• The layout works on mobile and desktop.
• Posters and titles are consistent across all items.
• Private or password-protected media uses the same access strategy across the playlist.
• Imported provider items have the correct thumbnails and titles.

Recommended patterns

Use case	Recommended layout
Online course module	Video player with list below or side list on wide pages.
Podcast archive	Audio playlist with track list below controls.
Product demos	Video playlist with strong poster images and list below the player.
Sermon or lecture series	Video or audio playlist grouped by date or series order.
Music album	Audio playlist with compact track list.

Related

• Playlist editor — create, import, order, and publish playlists
• Media — manage the media records inside playlists
• Video inspector panels — configure individual video items
• Access control — protect restricted playlist content