How do you embed a playlist?

As a paid Vimeo member [Plus and above], you can turn your showcases into embedded playlists, allowing you to showcase a collection of your videos through one player on your website. Embedded playlists can be viewed on both mobile devices and desktop.

In this article:

  • Embedding a playlist
  • Customizing embedded playlists
  • Privacy and playlists
  • Managing videos in a playlist
  • Inserting a playlist into another website
  • Individual video settings and Playlists
  • Video Aspect Ratio
  • Vimeo Legacy widgets for embedding playlists

Embedding a playlist

To get started, create or select a showcase from the video manager [//vimeo.com/manage/videos]. Once you're in your showcase's settings, click on the "Embed" tab under "Destinations." This will open up your playlists embed settings, as well as a preview of your playlist.



From here you can decide whether or not the embedded playlist will be responsive [so that the video will adapt to the height and width of its container in your website] or if you have fixed, custom dimensions youd like it to stick to [recommended]. This information will be reflected in the embed code above that you can copy and paste into your websites code.

Here is an example of an embedded playlist:

Hitting the down arrow below your playlist's thumbnail will collapse a menu containing all videos in the playlist [Note: it is not currently possible to disable the number of plays displayed next to each video].

Customizing embedded playlists

Vimeo Pro members and above have access to extra options for playlist customization:

  • Continuous Playback: Allow all videos in your playlist to play through continuously. Each "up next" video will load for viewers automatically.
  • Loop Playback:Automatically replay the playlist once the last video has finished.
  • Hide Vimeo Logo: Remove the Vimeo logo from the player.
  • Custom Logo: Upload a custom image file [such as a company logo] to appear in the player.We recommend using transparent 200×200 PNG files for best results.
  • Accent Color: Choose the exact color for the play bar.

Please note that the individual embed settings [i.e. color, end screens] set for the videos inside your playlist will be overridden by your playlist settings.

️It's not possible to set an embedded playlist to start playing automatically; viewers will need to manually start playback.

Privacy and playlists

Setting your showcase to Anyone [public] will allow your videos to be viewed in your showcase onvimeo.comand in an embedded playlist. You can also set your showcase to Hide from Vimeo.com, which will keep it off the Vimeo website, but make it embeddable. Lastly, you can use the Only People with a Password option to allow viewers to watch your videos on site, and in your embedded playlist, after entering a password.

For showcases set to "Anyone" or "Hide from Vimeo," videos with privacy settings applied will not appear in the embedded playlist. In other words:

  • Videos set to "Anyone" or "Hide from Vimeo" will appear in the embedded playlist
  • Videos set to"Unlisted", "Password", and "Private" will not appear in the embedded playlist.

For password-protected showcases [set to "only people with a password"], videoswill appear in the embedded playlist regardless of their individual privacy settings.

Keep in mind that any individual videos embed privacy setting [General > Privacy > Where can this be embedded?] will be respected when embedding a playlist. For example, if your individual video has domain-level privacy enabled, it will respect that setting even when added to an embeddable playlist.If the domain setting does not match the site where your playlist is embedded, your video[s] will not appear in the playlist.

Managing videos in a playlist

Videos will play in the order in which they are placed in a showcase. You can customize the order of your videos from the "Assets" tab of the Showcase settings page. To the right of the page, choose a sorting method from the dropdown menu above your videos [such as "Alphabetical"] or select "Custom" to drag and drop any videos to change their position.

You can also add or remove videos from your showcase at any time. Similar to individual videos, any changes made to your videos on Vimeo.com will be immediately reflected in your embedded playlist. There is no need to update your embed code after making adjustments to the videos inside your showcase.

Inserting a playlist into another website

In order to embed a playlist, you must use its respective embed code [whether fixed size or responsive]. Showcase URLs are often not supported by applications that rely on URLs instead of embed codes [for example: themes, plugins, galleries, etc.].

Heres some instructions on how to insert embed codes into the most common website builders:

  • Wix
    • In the Wix website editor, click +Add, select More at the bottom of the list, then choose the HTML Code option
    • Click the Enter code button above the new gray block on your page to bring up the editing modal
    • Make sure the Code option is selected, then paste in your playlists embed code
    • Click the blue Update button, then publish the changes to your site
  • Squarespace
    • Enter editing mode for your Squarespace page, then click the + Add block icon in the top right of the page
    • Scroll down through the menu until you reach the More heading, the select the Code option
    • Paste in your playlists embed code , then hit the Apply button
    • When youve finished making all edits to your page, hit Save in the top left corner
  • Tumblr
    • Choose Video from the selection of post types
    • Select Add video from web option
    • Paste in the playlist embed code
    • The embedded Vimeo player will load and youll have the option to add text to Tumblr post
    • When youre ready, hit the Post button

In addition to these options, you can also give your Showcase a custom URL if you already own a domain.

Individual video settings and Playlists

These individual video settings will be applied to videos within a playlist [with some caveats]:

  • Video cards
  • Chapters
  • If the first video in the playlist has contact formsadded as a screen before the video, it will appear at the start of the playlist.

Some embed features and customizations that are available for individual videos are not available for embedded playlists. This includes:

  • End screens: at the end of the last video, the player will instead show the thumbnail of the first video.
  • Live streams [archived live streams are supported, as they behave like normal videos once archived].
  • Defaulting to a specific playback quality [e.g 1080p, 4K, etc]
  • Starting playback at a specific timecode [via #t]
  • Sharing options
  • Watch Later / Offline Playback
  • Third-party player support [via direct links]
  • API support

Video Aspect Ratio

You can add videos of all shapes and sizes to an embedded playlist, but we recommend keeping the aspect ratio consistent for best results. If your playlist contains mixed sized videos [for example, 4:3 SD videos and 16:9 HD videos], black bars will be appended to the sides of the player to maintain your videos original aspect ratio in the playlist.

Vimeo Legacy widgets for embedding playlists

Longtime Vimeo members may remember using now outdated Flash-based widgets, known as Hubnut and Montage, which allowed you to embed collections to your website. These, unfortunately, were not mobile-compatible, and weve ceased supporting them.

Video liên quan

Chủ Đề