mediumBest Practices

SERP Opportunity: Video Pages Missing VideoObject Schema

Video pages lack VideoObject schema, missing eligibility for video rich results in search.

By Seoxpert Editorial · Published Apr 27, 2026

Why it matters

Adding VideoObject schema enables video thumbnails and rich results in search, which attract more attention and clicks. Without it, your videos may not appear in enhanced search features, reducing visibility and traffic.

Impact

Pages with video content may not appear as video rich results, missing out on higher click-through rates.

How it's detected

An automated crawler checks for the presence of VideoObject structured data on pages containing video content.

Common causes

•Video content embedded without adding VideoObject schema
•Developers unaware of schema requirements for video SEO
•CMS or plugins do not generate video structured data by default
•Migration or redesign removed schema markup

How to fix it

Add VideoObject structured data in JSON-LD format to each video page. Include required properties: name, description, thumbnailUrl, uploadDate, and contentUrl or embedUrl. Also include duration in ISO 8601 format if possible. Place the JSON-LD in the <head> or just before </body> of the HTML.

Code examples

Missing VideoObject schema (problem)

<!-- No VideoObject JSON-LD present on page -->

Correct VideoObject JSON-LD (solution)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How to Fix a Leaky Faucet",
  "description": "Step-by-step guide to repairing a leaky faucet.",
  "thumbnailUrl": "https://example.com/thumbnails/faucet.jpg",
  "uploadDate": "2024-05-10",
  "contentUrl": "https://example.com/videos/faucet.mp4",
  "duration": "PT4M30S"
}
</script>

FAQ

What properties are required in VideoObject schema for rich results?

You must include name, description, thumbnailUrl, uploadDate, and contentUrl or embedUrl. Duration is recommended.

Where should I place the VideoObject JSON-LD on my page?

Place the JSON-LD script in the <head> or just before the closing </body> tag of your HTML.

Can I use VideoObject schema for embedded YouTube or Vimeo videos?

Yes, use the embedUrl property to reference the video embed link.

Does adding VideoObject schema guarantee video rich results?

No, but it makes your page eligible. Google decides whether to show rich results.

Found this issue on your site?

Run a scan to see if SERP Opportunity: Video Pages Missing VideoObject Schema affects your pages.

Scan my website →