Webflow sync, pageviews & more.
NEW

How can I fix the issue with Google Console flagging alerts for videos on a Webflow page that do not have a thumbnail URL provided?

TL;DR
  • Add VideoObject schema manually using an Embed element in Webflow with required fields including thumbnailUrl, name, description, contentUrl, and uploadDate.
  • Use a valid image URL for thumbnailUrl (e.g., YouTube’s img.youtube.com) and verify the markup using Google’s Rich Results Test.

Google Search Console may flag a warning when videos on your Webflow site do not include a structured data property for a thumbnail URL. To fix this, you’ll need to ensure that your video elements include proper VideoObject schema with the required thumbnailUrl field.

1. Understand the Cause of the Warning

  • Google requires specific fields for videos embedded on a page to display enhanced results.
  • The thumbnailUrl property is required in the VideoObject schema to specify a preview image.
  • Webflow video embeds (e.g., YouTube, Vimeo) do not automatically generate schema with thumbnails.

2. Manually Add Video Schema Using Embed Element

  • Drag in an Embed element from the Add panel.
  • Inside the Embed, add your structured data as JSON-LD.
  • Replace placeholders with real data:
  • "name": Title of the video
  • "description": Short summary
  • "thumbnailUrl": Must be a URL pointing to an image (JPG/PNG)
  • "contentUrl": Direct link to the video file or hosting page
  • "uploadDate": In YYYY-MM-DD format

Example inline JSON-LD for YouTube video:

<script type="application/ld+json">{  "@context": "https://schema.org",  "@type": "VideoObject",  "name": "Your Video Title",  "description": "Short description",  "thumbnailUrl": "https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg",  "uploadDate": "2024-04-10",  "contentUrl": "https://www.youtube.com/watch?v=VIDEO_ID",  "embedUrl": "https://www.youtube.com/embed/VIDEO_ID"}</script>

Note: Webflow does not support fenced code blocks in the Designer, but this structure is acceptable in the Embed component.

3. Use a Valid Thumbnail URL

  • For YouTube: Use https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg
  • For Vimeo: You must manually upload a thumbnail to your site and link to the hosted image URL in Webflow’s asset folder or use Vimeo's API to fetch it.

4. Validate Structured Data

Summary

To resolve Google Console warnings about missing thumbnailUrl for videos in Webflow, manually add VideoObject structured data using the Embed component. Include a valid thumbnailUrl field, and verify using Google's Rich Results Test.

Rate this answer

Other Webflow Questions