If you embed videos on your website, Google may not understand them fully on its own. A short piece of structured data called VideoObject schema tells Google the title, description, thumbnail, upload date and length of the video. That can help your page appear in video results and with a thumbnail next to your listing. A cooking academy in Lahore added video schema to its recipe pages and began seeing those pages show up in the Videos tab of Google search.
What our generator creates
The Video Schema Generator builds clean JSON-LD code using your details:
- Video name and description
- Thumbnail URL
- Upload date
- Duration in the format Google expects
- Content URL or embed URL, such as a YouTube embed link
- Ready to paste code with copy and download buttons
How to use it
- Open the Video Schema Generator.
- Enter the video title and a clear description.
- Add the thumbnail image URL.
- Choose the upload date.
- Add the duration and the video or embed URL.
- Click Generate Schema and copy the code.
- Paste it into the head or body of the page that shows the video.
Where to add the code
Add the code to the page where the video is actually embedded and visible. On WordPress, you can use a header and footer code plugin or your SEO plugin's schema option. On a custom site, paste it inside a script tag of type application ld json. Only add video schema to pages where the video is a main part of the content.
Requirements Google looks for
- A visible video on the page, not hidden in a tab that never loads
- A valid thumbnail that Google can access
- An accurate upload date
- A name and description that match the video
- A crawlable video or embed URL
After adding the code, test it with our Schema Markup Validator to make sure there are no errors.
Tips for better video results
- Write a helpful description of two or three sentences, not just the title again.
- Use a clear, high quality thumbnail.
- Add chapters on YouTube with the help of the YouTube Description Generator, which can lead to key moments in search.
- Place the video near the top of the page when it is the main content.
- Add a text summary below the video for readers and search engines.
A real example
A driving school in Karachi had YouTube lessons embedded in blog posts but the posts never appeared in video results. We added VideoObject schema for each lesson with a proper thumbnail and description, and placed the video above the fold. After Google recrawled the pages, several lessons started appearing with thumbnails for searches like how to parallel park, bringing new students to the website instead of only to YouTube.
Common mistakes to avoid
- Adding schema for a video that is not on the page.
- Using a broken or tiny thumbnail URL.
- Copying one schema block to many pages without changing the details.
- Forgetting to update the code when you replace the video.
Keep the details in sync
If you update the video title on YouTube or replace the thumbnail, update the schema on your page too. Mismatched details can confuse Google and reduce the chance of rich video results. A quick check every few months is enough for most sites.
Frequently asked questions
Do I need video schema for YouTube embeds
Google can often understand YouTube embeds on its own, but schema gives clearer details and can improve your chances in video results.
What format is the duration
ISO 8601, such as PT5M30S for five minutes and thirty seconds. The generator formats it for you.
Does video schema guarantee a thumbnail in search
No. It makes your page eligible, but Google decides when to show video features.
Create your video schema now with the free Video Schema Generator.