VideoObject schema and YouTube embeds that don’t slow the page

By the DenverSEO.io team · 2026-11-01

Why bother with video at all?

In Ahrefs’ March 2026 study of about 4 million AI Overview citations, YouTube was the most-cited domain, and 18.2% of the cited pages that did not rank in the top 100 for that search were YouTube videos. Eye To Ad Media covered what that means for owners in does video help you show up in AI search. This post is the engineering half: getting the video onto your own page fast and machine-readable.

The problem with the default embed

Pasting YouTube’s embed code drops an <iframe> that pulls in the full player, its scripts and its trackers the moment the page loads, whether anyone presses play or not. On a phone that weight competes with your own content, and Lighthouse flags it under “Lazy load third-party resources with facades.”

At minimum, add loading="lazy" to the iframe so it waits until it nears the screen. Better is a facade.

A facade: show a picture, load the player on click

A facade is a static thumbnail with a play button. Nothing from YouTube’s player loads until the visitor clicks, then the real iframe replaces the picture and starts playing.

<button class="yt" data-id="VIDEO_ID" aria-label="Play: How much does a new roof cost?">
  <img src="https://i.ytimg.com/vi/VIDEO_ID/hqdefault.jpg" alt="" width="480" height="360" loading="lazy">
</button>
<script>
document.addEventListener('click', function (e) {
  var b = e.target.closest('.yt'); if (!b) return;
  var f = document.createElement('iframe');
  f.src = 'https://www.youtube-nocookie.com/embed/' + b.dataset.id + '?autoplay=1';
  f.title = b.getAttribute('aria-label');
  f.allow = 'autoplay; encrypted-media; picture-in-picture';
  f.allowFullscreen = true; f.width = 560; f.height = 315;
  b.replaceWith(f);
});
</script>

• Give the button a real accessible name: the question the video answers, not “video.”
• Set width and height on the image so nothing shifts when it loads.
• The youtube-nocookie.com domain avoids setting tracking cookies until the visitor plays the video.

The facade is only for your page. Search engines learn about the video from the structured data below, not from the iframe.

VideoObject: tell Google what the video is

Google’s video documentation requires three properties on VideoObject: name, thumbnailUrl and uploadDate. Recommended additions include description, duration, and either contentUrl or embedUrl. Put it on the page where the video actually appears, near the content it supports.

Validate the output with Google’s Rich Results Test before you ship it, and use the exact upload date shown on YouTube.

Put the transcript on the page

AI systems work from text. Peec AI’s 2026 research found Google AI Mode building answers from both a video’s description and its transcript. Two things follow:

• Fix YouTube’s auto-captions first. They routinely misspell business names, trade terms and street names.
• Print the corrected transcript on your page under the video, in a collapsible <details> block if it is long. It is real, indexable text that matches the video, and it helps visitors who cannot play sound.

For longer videos, Google also supports key moments: either Clip markup with start and end times you choose, or SeekToAction so Google can pick them itself.

The checklist

1. One video per page, next to the content it supports.
2. Facade embed, or at least loading="lazy".
3. VideoObject with name, thumbnailUrl, uploadDate, plus description, duration and embedUrl.
4. Corrected transcript on the page.
5. Same title and description on YouTube, with a link back to the page.
6. Rich Results Test passes, and the page still passes Core Web Vitals on mobile.

If you would rather hand off the whole thing (scripting, filming, YouTube and the page), Eye To Ad Media’s video SEO service does that end to end. If you want the code done, send us the page.