Skip to main content
New: 189 SEO checks now available. See what's new
mediumStructured dataSCHEMA_VIDEO_MISSING_FIELDS

Video schema missing recommended fields — the fix

The VideoObject structured data is missing recommended fields such as thumbnailUrl, uploadDate, duration, or description. These are needed for video rich results.

Where this fits: structured data in SEO

Structured data (JSON-LD / schema.org) is how you describe your content to machines in their own vocabulary: this is a product with this price, an article by this author, an event on this date. It powers rich results — stars, FAQs, breadcrumbs, product info — which materially raise click-through rates. Invalid or incomplete markup doesn't just miss the enhancement; sustained abuse can earn manual actions, so correctness matters as much as presence.

Why video schema missing recommended fields hurts your rankings

Video rich results with complete metadata (thumbnail, duration, upload date) are significantly more prominent in search results and can appear in video carousels. Missing fields reduce eligibility for these enhanced displays and lower click-through rates.

This is a medium-severity issue: individually modest, but it compounds — dozens of medium issues across hundreds of pages add up to a real quality deficit in how search engines assess the site.

How to fix it

Add recommended fields to your VideoObject schema: thumbnailUrl, uploadDate (ISO 8601), duration (ISO 8601), description, and contentUrl or embedUrl.

Structured data best practices

  • Use JSON-LD in the head, one graph per page, validated against schema.org.
  • Mark up what's actually on the page — invisible markup risks manual actions.
  • Complete the fields rich results need: price+availability for products, dates for events, steps for how-tos.
  • Add Organization + WebSite schema sitewide, and sameAs links to every social profile.
  • Re-validate after redesigns — markup silently breaks when templates change.

The full library: SEO best practices, by category.

Frequently asked questions

What does "Video schema missing recommended fields" mean?

The VideoObject structured data is missing recommended fields such as thumbnailUrl, uploadDate, duration, or description. These are needed for video rich results.

Why does video schema missing recommended fields matter for SEO?

Video rich results with complete metadata (thumbnail, duration, upload date) are significantly more prominent in search results and can appear in video carousels. Missing fields reduce eligibility for these enhanced displays and lower click-through rates.

How do I fix video schema missing recommended fields?

Add recommended fields to your VideoObject schema: thumbnailUrl, uploadDate (ISO 8601), duration (ISO 8601), description, and contentUrl or embedUrl.

How serious is this issue?

This is a medium-severity issue: individually modest, but it compounds — dozens of medium issues across hundreds of pages add up to a real quality deficit in how search engines assess the site. It belongs to the structured data family of checks.

How do I find every page affected by this on my site?

Run a free Dr Urls audit: it crawls your site, detects video schema missing recommended fields on every affected page, shows example URLs, and generates a ready-to-use fix task. Re-scan after fixing to verify the issue is gone.

Does your site have this issue?

Dr Urls does not report this one in an audit today, so check it by hand with the steps above. An audit runs every check it does report, with a ready-made fix task for each.

Check my site free

Related structured data guides