How can I add a custom thumbnail over the Vimeo player in Webflow, similar to how it is done on Squarespace?

TL;DR
  • Add a thumbnail image with a play button overlay using absolute positioning in a relative container.  
  • Embed the Vimeo iframe with autoplay=1&muted=1, initially hidden, and use a click interaction to hide the thumbnail and reveal the video.

To add a custom thumbnail overlay on a Vimeo player in Webflow, you need to simulate the "cover thumbnail" behavior by using an image with play button styling that transitions to an embedded video on click.

​

1. Add the Custom Thumbnail Image

​

  • Drag an Image element into your Webflow layout where you want the video.
  • Set the image to your desired thumbnail/cover image.
  • Add a play button icon or SVG overlay using a Div Block with absolute positioning, placed over the image. This mimics the standard video thumbnail look.

​

2. Prepare the Vimeo Embed

​

  • Get the Vimeo embed URL from Vimeo, use the format:  

  https://player.vimeo.com/video/VIDEO-ID?autoplay=1&muted=1

  • The ?autoplay=1&muted=1 parameters ensure it autoplays, which is often required due to browser restrictions.
  • In Webflow, use an Embed element and paste the iframe code using the Embed code widget (from the Add panel → Components → Embed).
  • Make sure the iframe is set to the correct dimensions with display: none initially (can be set in a div with class “video-player” that’s hidden on page load).

​

3. Use Interactions to Toggle Display

​

  • Select the thumbnail wrapper (e.g., a Div containing image and play icon).
  • Go to Interactions panel → Element trigger → Mouse click (tap).
  • Create an animation that:
  • Hides the thumbnail (e.g., display: none or opacity to 0).
  • Shows the iframe-containing div (e.g., display: block or opacity to 1).
  • Make sure the Vimeo iframe URL includes autoplay=1 to start playback immediately.

​

4. Style As Needed

​

  • Ensure the thumbnail image and iframe video are both in the same position and dimensions.
  • Use position: absolute over a common relative container if you want them to fully overlap.

​

Summary

​

To simulate a custom thumbnail for a Vimeo video in Webflow, place an image with a play button overlay above a hidden Vimeo iframe. Use an interaction to swap the thumbnail for the video element on click, using autoplay=1 to play instantly. This recreates the Squarespace-style thumbnail overlay behavior.

Rate this answer

Other Webflow Questions