AI Visibility

Video Schema and YouTube SEO: JSON-LD for Video Content and AI Visibility

By Reviewed by Hawrry Bhattarai
September 2, 2026 8 min read
Contents
TL;DR — the short answer

How to implement VideoObject schema JSON-LD for video rich results, YouTube SEO, and AI citation of video content. Includes transcript, thumbnail, and duration properties.

7 min read · AI Visibility · Last updated July 2026

Quick answer: VideoObject schema marks up video content with title, description, thumbnail, duration, upload date, and transcript in machine-readable JSON-LD. It enables video rich results in Google (the video carousel), improves YouTube discovery, and helps AI systems understand and cite video content in response to relevant queries.

Introduction

Video content has a discoverability problem: search engines and AI systems cannot watch videos. They rely on metadata — title, description, transcript, schema — to understand what a video contains.

VideoObject schema bridges this gap. It provides structured metadata that search engines use for video rich results and AI systems use for video content comprehension.

For businesses with YouTube channels, tutorial libraries, or video testimonials, VideoObject schema is underused but high-impact.

What you’ll learn:
– The complete VideoObject schema property set
– How to embed VideoObject schema on pages featuring video
– Transcript integration for AI comprehension
– YouTube-specific SEO signals that complement schema
– Video content and AI citation


Table of Contents

  1. VideoObject Schema Structure
  2. Required Properties for Video Rich Results
  3. Transcript and Description Optimization
  4. Embedding Videos with Schema
  5. YouTube SEO and Schema Interaction
  6. AI Citation of Video Content
  7. Frequently Asked Questions

VideoObject Schema Structure

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How to Build an AI-Ready Entity for Your Business in 2026",
  "description": "Step-by-step walkthrough of building a complete digital entity for AI visibility — covering Google Business Profile, LinkedIn, Wikidata, schema markup, and sameAs connections. Published by Ignited Nepal.",
  "thumbnailUrl": "https://ignitednepal.com/videos/entity-building-2026-thumb.jpg",
  "uploadDate": "2026-07-10",
  "duration": "PT14M32S",
  "contentUrl": "https://www.youtube.com/watch?v=EXAMPLE_ID",
  "embedUrl": "https://www.youtube.com/embed/EXAMPLE_ID",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": {"@type": "WatchAction"},
    "userInteractionCount": 4721
  },
  "author": {
    "@type": "Person",
    "name": "Priya Sharma",
    "url": "https://ignitednepal.com/team/priya-sharma/"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Ignited Nepal",
    "logo": {"@type": "ImageObject", "url": "https://ignitednepal.com/images/logo.png"}
  }
}

Required Properties for Video Rich Results

Google requires these properties for video rich results eligibility:

name — The video title. Use the exact same title as the video. Keyword-relevant but natural.

description — Detailed video description. 50-300 words describing the content. AI systems use this as a primary comprehension signal when the video cannot be watched.

thumbnailUrl — High-resolution thumbnail URL. Must be at minimum 60×30 pixels (Google recommends 1280×720 pixels). Thumbnails with faces or clear visual context outperform abstract images for CTR.

uploadDate — ISO 8601 date format (YYYY-MM-DD). Required for freshness signals.

duration — ISO 8601 duration format (PT14M32S = 14 minutes 32 seconds).

Optional but strongly recommended:
contentUrl — Direct URL to the video file or YouTube watch URL
embedUrl — Embeddable player URL (YouTube embed format)
transcript — Full video transcript text (extremely valuable for AI comprehension)


Transcript and Description Optimization

The transcript property: Adding a full transcript to VideoObject schema (or providing a visible transcript on the page) dramatically improves AI systems’ ability to comprehend and cite your video content.

"transcript": "Welcome to this guide on AI visibility for businesses. Today we're covering the five core entity signals that determine whether AI systems like ChatGPT and Gemini mention your brand when users ask about your category. Let's start with the most fundamental signal: your Google Business Profile..."

Transcripts allow AI systems to:
1. Extract specific claims and quotes from your video
2. Cite your video for queries about topics covered in it
3. Understand the full scope of content without watching

On-page transcripts: Consider publishing the full transcript as text content below your embedded video. This serves both accessibility (users who prefer reading) and AI extraction (AI systems that index page text).

Description optimization: The description property in VideoObject schema can be longer and more detailed than YouTube’s description. Use it to:
– Summarize key points (in extractable sentences)
– Include relevant terminology for the topic
– Mention specific methodologies, tools, or statistics covered


Embedding Videos with Schema

For videos embedded from YouTube on your website:

<div itemscope itemtype="https://schema.org/VideoObject">
  <iframe width="100%" height="450" 
    src="https://www.youtube.com/embed/EXAMPLE_ID"
    title="How to Build an AI-Ready Entity for Your Business"
    frameborder="0" allowfullscreen>
  </iframe>
</div>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How to Build an AI-Ready Entity for Your Business in 2026",
  "description": "...",
  "thumbnailUrl": "...",
  "uploadDate": "2026-07-10",
  "duration": "PT14M32S",
  "contentUrl": "https://www.youtube.com/watch?v=EXAMPLE_ID",
  "embedUrl": "https://www.youtube.com/embed/EXAMPLE_ID"
}
</script>

Place the JSON-LD in the page’s <head> or alongside the video embed. Google’s crawler associates the schema with the page’s video content.


YouTube SEO and Schema Interaction

VideoObject schema on your website and YouTube’s internal signals work together but independently:

YouTube signals (not affected by schema):
– Video title, description, and tags in YouTube
– Watch time and retention rate
– Click-through rate from YouTube search
– Engagement (likes, comments, shares)
– Channel authority and subscriber count

Website schema signals (separate system):
– VideoObject JSON-LD on your website page
– Tells Google Search about the video content
– Enables video rich results for your website’s URLs
– Helps AI systems index video content from your pages

The combined benefit: A video with strong YouTube signals AND proper VideoObject schema on your website appears in two places: YouTube search and Google web search (potentially with video rich results). This dual visibility significantly increases total impressions for your video content.


AI Citation of Video Content

AI systems primarily cite text content, but video content can influence AI responses in two ways:

Via transcript: If you provide a full transcript in the VideoObject schema or as page text, AI systems can extract specific claims and quote them like text content.

Via description: A detailed VideoObject description containing specific statistics, methodologies, or unique insights can be extracted and cited similarly to text content.

Via secondary references: If other sites or publications reference your video content in text form (“In a recent video, Ignited Nepal demonstrated…”), those text references become citable AI content.

For video-first businesses, the practical recommendation is: always publish text content alongside videos. Either a full transcript, a detailed written summary, or a companion blog post. Pure video with minimal text is invisible to AI citation systems.

VideoObject Schema Checklist

Schema Completeness
0/10


Frequently Asked Questions

Q: Does VideoObject schema help YouTube video ranking?
A: Not directly — YouTube’s ranking algorithm is separate from Google Search. VideoObject schema on your website helps your website pages rank in Google for video queries and enables video rich results. Your YouTube channel’s performance in YouTube search is governed by YouTube’s own signals.

Q: How do I generate the ISO 8601 duration format?
A: Use the format PT[hours]H[minutes]M[seconds]S. A 14-minute 32-second video is PT14M32S. A 1-hour 5-minute video is PT1H5M0S. Most video hosting platforms provide this data via their APIs.

Q: Should I add VideoObject schema to every page that has a video?
A: Yes, for pages where video is the primary content. For pages with a small embedded video supplementing text content, prioritize the Article schema for the page and optionally add VideoObject for the video component.


Conclusion

VideoObject schema transforms your video content from visually rich but AI-invisible to machine-readable and citation-ready. Combined with a published transcript and a strong description, your video content can influence AI responses just as text content does. Implement VideoObject schema on all primary video pages and companion blog posts for maximum dual-channel visibility.


Get AI-Ready with Ignited Nepal

We implement VideoObject, Article, FAQPage, and complete schema stacks for businesses with mixed content strategies.

→ Request an AI Visibility Audit


Written by the Ignited Nepal AI Visibility team. ignitednepal.com

NR

Article by

Niraj Raut

Head of Search at Ignited Nepal. Drove 340% organic traffic growth for EzyDog (Australia), 4× revenue for The Turf Man (Australia), and 120% month-on-month traffic growth for ThemeGrill (Nepal). Keynote speaker at WordCamp Nepal 2023 and verified WordPress.org open-source contributor.