Video Schema: Structured Data for Video Results

What It Is

Video schema is structured data, usually JSON-LD, that describes a video to search engines.

It declares the name, description, thumbnail, and URL of the video.

When valid, it can qualify the page for rich video results.

What It Includes

• The name and description of the video.
• The thumbnail URL for display.
• The content URL or embed URL where the video lives.
• The upload date and duration.
• Metadata like transcript or uploader.

Why It Matters

• Valid schema is required for rich video results.
• Rich results show thumbnails and details that lift clicks.
• It tells search engines a page actually contains video.
• It makes the video eligible across Google properties.
• It is the clearest signal a video is on the page.

How to Implement

• Add JSON-LD VideoObject to the page containing the video.
• Use a real, indexable URL for the video.
• Keep the schema in sync with the visible page.
• Validate the markup with the Rich Results Test.
• Match the schema fields to the actual video.

Common Mistakes

• Adding schema to pages without visible video.
• Using embed URLs that are not indexable.
• Mismatching the thumbnail or description.
• Forgetting required fields like name and duration.
• Never validating the markup after changes.

Frequently Asked Questions

Video Schema, in Short

Video schema tells search engines a video exists.

Describe it fully and keep it in sync with the page.

Valid markup unlocks the rich result your video deserves.