SEO guides

Describe video playback and availability in JSON-LD

·

Start with the details viewers can see on the watch page. Use separate fields for the watch page, the embedded player and the actual media file.

Video Schema Generator

Check the duration and watch data

Choose Load example and Generate VideoObject markup. Pull a two-color relief print has a duration of PT2M30S and separate video-file and player URLs. The thumbnail points to the recording artwork, and the upload timestamp is 2026-11-21T15:00:00Z.

The 1920 × 1080 video has a bitrate of 4000 kbps. interactionStatistic contains a WatchAction and 1,250 views. The region rule publishes CA and US in regionsAllowed.

Schema.org VideoObjectGoogle Search VideoObject and BroadcastEvent markup

Add a future broadcast to the same example

Set Live broadcast to Yes. Enter 2026-12-06T17:00:00Z as Broadcast start and 2026-12-06T17:45:00Z as Broadcast end. Generate again. publication contains a BroadcastEvent with those dates and isLiveBroadcast set to true.

Use accurate times, including the end once the stream finishes. Google uses its own published requirements when it evaluates a live badge.

Schema.org BroadcastEventGoogle Search VideoObject and BroadcastEvent markup

Review the actual destinations before publishing

Use the watch page address for url, direct movie bytes for contentUrl and a player page for embedUrl. Verify that the visible video and image are accessible to the intended audience. The tool checks the addresses locally as text.

Copy JSON-LD into a field that already wraps it. Choose HTML script when your publishing template expects the entire script block.

Schema.org VideoObjectGoogle Search VideoObject and BroadcastEvent markup

Common questions

Does the view count come from the linked platform?

The markup describes the count you entered. Any authoritative count must come from the published video platform.

How can I switch from allowlisting to blocking countries?

Change Region rule to Exclude listed countries. The new export uses ineligibleRegion and omits regionsAllowed.

Sources

Put it into practice.

Related guides