Skip to main content

Video Schema Generator: Create VideoObject JSON-LD for Your Page

A video schema generator writes the structured data that tells Google what a video on your page is about. Fill in the title, description, thumbnail, upload date and duration, and the tool outputs VideoObject code in JSON-LD format. Free to use.

Video details

JPEG or PNG image, 1280 x 720 px or larger recommended

Direct link to the video file (MP4, WebM)

YouTube, Vimeo or any other embedded player URL

Fill in the fields marked * to generate valid markup.

JSON-LD code

<!-- Generated with Ichiban SEO: https://ichibanseo.com/en/tools/video-schema-generator -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject"
}
</script>

How do I use this markup?

  1. Copy the code above.
  2. Paste it in the <head> of your HTML page, or in the matching custom code field of your CMS.
  3. Test it with Rich Results Test from Google.
The contentUrl and embedUrl fields are optional, but Google recommends at least one of them so it can find and understand the video.

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.

PropertyStatusWhat to enter
nameRequiredVideo title
thumbnailUrlRequiredImage URL
uploadDateRequiredDate in ISO 8601
descriptionRecommendedShort summary
durationRecommendedISO 8601, such as PT1M30S
contentUrl / embedUrlRecommendedFile 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

Frequently asked questions

Video schema is structured data written in the schema.org VideoObject format. It describes a video on a page, including its title, thumbnail, upload date and duration, so Google can understand it and may show it in video results.

Share this page

We audit your profile. Then we talk.

Book 30 minutes on video with the founder. We prepare your local SEO audit, go through it together, and you decide.

Free audit, reply within 24 hours. You sign nothing today.
  1. 01
    You book your call
    Pick a 30-minute slot in the founder’s calendar.
  2. 02
    We run your audit
    We review your profile, your local opportunities and your competitors before the call.
  3. 03
    We go over it on video
    We walk you through the results and talk it over openly, whether we work together or not.

ICHI, local SEO assistant

Ichiban SEO is the local SEO agency that specializes in Google Maps, founded by Nathanaël Butet. ICHI answers anything about the agency in a few seconds.

What we do

Local SEO only: getting your business into the Google Maps local pack for your city and your trade.

The guarantee

Google Business Profile optimized within 24h of getting your access, or your 2nd month is free.

Your competitor

One professional per city and per industry. Your direct competitor cannot hire us.

Pricing

Ascension: $497/month. Domination: $897/month. No setup fee.

The method

Optimized Google profile, consistent listings, customer reviews, local pages, proximity links, rank tracking.

The free audit

30 minutes on a video call with Nathanaël: we check whether your spot is open and size your potential.

Ask ICHI

Book my free audit

ICHI is an AI and can make mistakes. For advice on your case, book the free audit with the team.