What is Video Schema Generator?
VideoObject schema describes a real video with fields such as name, description, thumbnail, upload date and a content or embed URL. This generator creates a focused JSON-LD object from information you already have, rather than fabricating duration, interaction counts or publisher metrics.
Video pages often depend on JavaScript players, which can make metadata inconsistent between the visible player and page source. Structured data gives a machine-readable description, but only when the URLs and dates remain synchronized with the real media asset.
How to use the Video Schema Generator
- 1Enter the exact visible video title and description.
- 2Provide a crawlable thumbnail URL.
- 3Use the real upload date.
- 4Add the direct content or embed URL used by the page.
- 5Generate the JSON-LD and validate it alongside the rendered player page.
Understanding the results
- `name` and `description` describe the video content.
- `thumbnailUrl` points to an image representing the video.
- `uploadDate` records when the video was originally published.
- `contentUrl` can identify the media file, while `embedUrl` is often used for a player URL in more advanced implementations.
Common problems
- Thumbnail URL blocked by authentication or hotlink rules.
- Upload date changes on every page update.
- Schema describes a video that is not actually present on the page.
- Title in schema differs from the player title and page heading.
How to fix them
- Use stable public media and thumbnail URLs.
- Keep upload date separate from page modification date.
- Generate video fields from the same media record used by the player.
- Remove video markup when the video is removed from the page.
VideoObject schema best practices
- Use high-quality representative thumbnails.
- Keep descriptions specific rather than promotional filler.
- Add duration only when you have the real duration value.
- Do not invent view counts or engagement statistics.
Practical example
What this tool cannot tell you
The generator creates a base VideoObject. Search-engine video features may require additional properties, crawlable media and technical playback conditions outside the JSON-LD itself.
Frequently asked questions
Do I need a thumbnail URL?+
Video structured data commonly relies on a representative thumbnail. Use a real accessible image.
What is the difference between contentUrl and embedUrl?+
contentUrl points to the media resource; embedUrl points to a player URL. Use the property that matches your implementation.
Should uploadDate change when I edit the page?+
No. It should represent the video's publication date, not routine page edits.
Can I use VideoObject for a GIF?+
Use the type for actual video content rather than stretching it to unrelated media formats.
Does VideoObject guarantee a video result?+
No. Search engines evaluate additional content and technical signals before showing video features.
Related SEO tools
Schema Markup Validator
Parse JSON-LD structured data, identify syntax or basic structural issues and show the detected Schema.org types.
JSON-LD Validator
Check whether JSON-LD parses as valid JSON and whether common linked-data fields are shaped correctly.
Article Schema Generator
Create Article JSON-LD with headline, URL, author and publication information supplied by you.