For a local business the use is simple: a short job walkthrough, a customer explainer or a service demo on a page. The markup helps Google understand and index the video.
Copy the code, paste it into the page and test it with Google's Rich Results Test.
How to use the video schema generator
Fill in the video title, description, upload date, duration and thumbnail URL. Add either a link to the video file or the embed URL from your player. Copy the JSON-LD block and paste it into the page that shows the video. Then test the live page.
Fields marked with an asterisk are required for valid markup. The tool tells you what is still missing and shows the finished duration in ISO 8601 format, such as PT2M30S for two and a half minutes.
Required and recommended VideoObject properties
Google requires a name, a thumbnail URL and an upload date for video markup. It recommends a description, a duration and a link to the video, either contentUrl for the file or embedUrl for the player. The more complete the data, the easier it is for Google to understand the video.
The thumbnail should be a real image of the video, reachable by Googlebot. A logo as the thumbnail is a missed chance and may be ignored.
| Property | Status | What to enter |
|---|---|---|
| name | Required | Video title |
| thumbnailUrl | Required | Image URL |
| uploadDate | Required | Date in ISO 8601 |
| description | Recommended | Short summary |
| duration | Recommended | ISO 8601, such as PT1M30S |
| contentUrl / embedUrl | Recommended | File or player URL |
Where to put the video schema code
Paste the script block into the head or the body of the page that displays the video. The page must show the video itself, and the markup must describe that video. Do not add video markup to pages where the video is not visible to visitors.
If you use a CMS or a site builder, look for a custom code or header section on the page. If you use a plugin, check that it is not already adding its own VideoObject, since two copies can conflict.
Test the markup before you publish
Open Google's Rich Results Test, enter the page URL or paste the code, and check for errors. Fix any missing required field and test again. Then use the URL Inspection tool in Search Console to request indexing for the page, and watch the video report for problems.
A valid markup does not guarantee a video rich result. Google decides what to show, but invalid markup rules it out.
How video helps local pages
A short video on a service or city page shows real work and answers questions the text cannot, such as what the crew does on arrival. Schema helps Google recognize the video. Host the video on a platform you control or on YouTube, and keep the page text useful on its own.
Keep the video relevant to the page. A video about water heater repair belongs on the water heater page, not on the home page.
Choose a good thumbnail and description
A clear thumbnail and a descriptive title and description help both viewers and search engines understand the video. The thumbnail should be a real image of the video, not a generic graphic.
Use a stable image URL that Google can reach and make sure it is not blocked by robots rules.
Write the description for a person: what happens in the video and why it is useful.
YouTube or self-hosted video
Embedding a YouTube video is simple and works well for most local businesses. Self-hosting gives more control but needs bandwidth, a player and more care with the markup.
With YouTube, use the embed URL for embedUrl. With a file you host, use the direct file address for contentUrl.
Whichever you choose, the video should be easy to find on the page and not hidden behind a click or a login.
Make sure Google can find your videos
Google needs to see the video on a page it can crawl. Put it near the top of a relevant page and check indexing in the video report of Google Search Console.
A video sitemap can help if you have many videos, but for a handful of videos good markup and a good page are enough.
Do not put the only copy of the information inside the video. Add a short text summary on the page.
Common video markup errors
The usual problems are a missing thumbnail, an invalid date format, a duration written in the wrong format and a URL that returns an error.
Use the ISO 8601 date format and write the duration the same way, for example PT2M30S for two minutes and thirty seconds.
Test the final page and fix any warning the testing tool shows before you publish.
Want structured data done for you?
We add the markup that matters for local pages, from business details to FAQs. Start with an audit. See our pricing or book a free audit.
Keep going:
Source: Google Search Central: Video structured data, Schema.org: VideoObject