How to Use Schema.org Markup for Your Videos

Why VideoObject Still Matters

Search engines and large language models rely on structured data to understand non‑text content. When you mark up a video with VideoObject you give the system clear fields such as title, description, thumbnail URL, content URL and duration. This reduces guesswork and increases the chance that the video will be selected as a direct answer or shown in a video carousel. For law firms, healthcare practices and other regulated businesses the benefit is twofold: potential clients can see a relevant video excerpt without leaving the answer, and the video earns a citation that drives traffic back to your site.

Choosing the Markup Format

In recent years the preferred way to embed VideoObject is JSON‑LD placed in the head of the page or just before the closing body tag. JSON‑LD keeps the markup separate from HTML, making it easier to maintain and less prone to errors caused by mismatched tags. Microdata and RDFa still work but they require inline attributes that can clutter the source and are more likely to break during template updates. If you already have microdata in place you can leave it, but new implementations should use JSON‑LD for consistency with other schema types you may be adding.

Required Properties for a Valid VideoObject

At a minimum a VideoObject needs the following properties: name, description, thumbnailURL, contentURL or embedURL, uploadDate and duration. The name should match the visible headline on the page. The description should be a concise summary of the video’s topic. thumbnailURL must point to an image that accurately represents the video and meets the size guidelines of the target platform. contentURL is the direct link to the video file; embedURL can be used when the video is hosted on a third‑party platform that provides an embed code. uploadDate should be expressed in a standard date time format. duration is also expressed in a standard time format. Providing these core properties ensures that the video is recognized as a valid VideoObject by search and AI systems.

Adding Optional Properties for Richer Answers

Beyond the required fields you can include properties that help AI systems surface more specific information. The property "actor" or "director" can be useful for training or interview videos. "genre" helps categorize content such as "continuing legal education" or "patient wellness". "regionsAllowed" lets you specify where the video may be shown, which is relevant for practices with geographic licensing restrictions. "isAccessibleForFree" signals whether the video is behind a paywall, a factor that some answer engines consider when deciding to cite. Including these optional fields does not guarantee a richer display but it gives the system more data to work with.

VideoObject and Related Extensions

Schema.org also offers extensions such as Clip and SeekToAction that work alongside VideoObject. Clip lets you mark important segments within a longer video, enabling answer engines to jump directly to the relevant part. SeekToAction provides a template for timestamp‑based navigation, which is helpful for webinars or multi‑topic recordings. Using these extensions does not replace the base VideoObject; rather they are added as separate items within the same JSON‑LD block. For a firm publishing a lengthy presentation, you might add Clip objects for each major section covered, making it easier for a user asking about a specific point to be directed to the exact moment.

Validation and Testing

After you insert the markup, test it with Google’s Rich Results Test or the Schema Markup Validator. These tools will report missing required fields, syntax errors, or warnings about image size. Fix any errors before publishing. It is also useful to inspect the rendered HTML in a browser’s developer tools to confirm the JSON‑LD script tag is present and contains the expected text. Regularly re‑test after any site updates, as template changes can accidentally remove or alter the script block.

Monitoring Impact

Because structured data does not directly affect rankings, monitor impact through rich result impressions and clicks in Google Search Console, and through referral analytics from answer engines. Look for increases in video carousel appearances or in the number of times your video is cited in AI‑generated answers. If you see no change after several weeks, double‑check that the page is indexable, that the video file is accessible to crawlers, and that the markup matches the visible content on the page.

Practical Example for a Law Firm

Suppose you have a video titled "Understanding the New Data Privacy Law for Healthcare Providers". The JSON‑LD block might look like this:

{ "@context": "https://schema.org\

Back to the blog index