When your page has an embedded video, SuperSchema can generate VideoObject schema: the markup that makes a page eligible for video rich results and helps AI understand what the video is about. It recognizes the major players by how they embed, pulls out the video ID, and fills in a canonical URL, the embed link, and a thumbnail where the platform provides a predictable one.
Supported players #
| Provider | How it is detected | Thumbnail filled automatically |
|---|---|---|
| YouTube | iframe embeds, youtu.be links, and web components like lite-youtube and youtube-player. | Yes |
| Vimeo | iframe embeds and vimeo-player web components, or a data-vimeo-id. | Yes |
| Wistia | iframe, wistia-player web component, wistia_embed and wistia_async classes, media-id, and data attributes. | Yes |
| HubSpot | HubSpot video embeds (excluding meeting schedulers, forms, and other non-video embeds). | No |
| Vidyard | iframe embeds, vidyard classes, or a data-vidyard-id. | No |
| Brightcove | Brightcove iframe embeds and video-js players with a data-video-id. | No |
| Loom | Loom share and embed iframes. | From the embed where available |
| Native HTML5 | A <video> element with a src or a <source>, using the poster attribute as the thumbnail. | When a poster is set |
How detection works #
When you generate with the VideoObject type selected, SuperSchema waits specifically for video elements to appear before it reads the page. Many players (Wistia, YouTube, Vimeo, and others) load their embed through JavaScript after the initial page load, so this extra wait gives them time to render.
- It scans for known embed patterns: player iframes, web components, and provider-specific classes and data attributes.
- It extracts the video ID and builds a canonical video URL and an embed URL for each match.
- It de-duplicates, so the same video embedded twice does not appear twice.
- It carries through provider, title, thumbnail, and dimensions when the page exposes them.
If a video is not detected #
- Confirm the video is from a supported provider and is embedded in the page, not linked as a plain URL.
- Make sure the video is present in the page content, not loaded only after a click, a tab switch, or a login.
- Generate again with the VideoObject type selected so SuperSchema waits specifically for the video to load.
- If it still is not found, add the video details by hand in the Schema Editor.
Editing video details #
You can always add or correct video details in the Schema Editor. This is where you set a thumbnailUrl for providers that do not supply one automatically, and where you can fill in a clear name, description, uploadDate, or duration to make the schema more complete.