VideoObject Schema: Markup Google Understands

Structured data is a labeled package for crawlers

VideoObject is a set of fields that describes a video in a format machines parse without guessing. It names the video, states how long it runs, and points to its image.

Google cannot watch your video. Markup is how you tell it the basics that a human would notice in two seconds of playback.

Required and recommended fields

Validation tools flag missing required fields first, but the recommended ones often decide whether a rich result appears.

• Name and description: the title and a short summary that match what viewers actually see.
• Thumbnail URL: a reachable image, since Google will not display a clip without one.
• Upload date: when the video first went live, kept accurate across updates.
• Duration: the runtime in a standard format so the result can label it.
• Content URL and embed URL: where Google can fetch the video and where it can play it.

Markup has to match the page

The fastest way to lose a rich result is to describe one video in the markup and show another on the page. Google compares the two.

I keep the schema in the page head and the visible content in the body, then read both side by side to check they agree on the title and the runtime.

The errors I see most

Broken thumbnail links top the list. The URL returns a 404, and the result drops the image without warning.

A close second is a duration that does not match the actual file. Small differences pass, but a five minute claim on a two minute clip gets caught.

Last is neglecting updates. When you replace a video, update the upload date and the thumbnail or the stale data lingers for weeks.

Schema is a contract. Whatever you write in it, Google expects the page to honor in front of a real viewer.

Key takeaways

• Describe the video Google can actually see on the page.
• Keep the thumbnail URL reachable and the duration honest.
• Test with a validation tool before you publish.
• Refresh the markup whenever the video changes.