VideoObject Schema: Helping Your Video Appear in AI Results and Rich Results

Video is the content format that AI search is prioritizing more than ever. Perplexity cites video in its answers, ChatGPT with search links to YouTube, and Google AI Overviews embeds video clips. But for AI to "see" and "understand" your video — you need VideoObject schema.

This is the complete guide to declaring VideoObject schema correctly, from basic fields to advanced Key Moments.

Why VideoObject Schema Matters for AEO

When AI reads your web page, it sees two types of information about video:

VideoObject schema is not just good for SEO — it is the language that allows AI to parse video content in a structured way.

All VideoObject Fields — Priority Levels

Complete VideoObject JSON-LD

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "@id": "https://example.vn/blog/aeo-la-gi#video",
  "name": "AEO là gì? Tối ưu cho AI Search trong 10 phút",
  "description": "Video hướng dẫn đầy đủ về Answer Engine Optimization (AEO): định nghĩa, tại sao quan trọng với doanh nghiệp Việt Nam năm 2026, và 3 bước đầu tiên để bắt đầu tối ưu cho ChatGPT, Perplexity và Google AI Overviews.",
  "thumbnailUrl": "https://example.vn/images/aeo-la-gi-thumb.jpg",
  "uploadDate": "2026-08-10",
  "duration": "PT10M45S",
  "contentUrl": "https://example.vn/videos/aeo-la-gi.mp4",
  "embedUrl": "https://www.youtube.com/embed/dQw4w9WgXcQ",
  "author": {
    "@type": "Person",
    "@id": "https://example.vn/tac-gia/tran-minh-duc",
    "name": "Trần Minh Đức"
  },
  "publisher": {
    "@type": "Organization",
    "@id": "https://example.vn",
    "name": "AEO Saigon",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.vn/icon.svg"
    }
  },
  "dateModified": "2026-08-10",
  "inLanguage": "vi",
  "hasPart": [
    {
      "@type": "Clip",
      "name": "AEO là gì?",
      "startOffset": 0,
      "endOffset": 90,
      "url": "https://www.youtube.com/embed/dQw4w9WgXcQ?start=0"
    },
    {
      "@type": "Clip",
      "name": "Tại sao AI search quan trọng năm 2026",
      "startOffset": 91,
      "endOffset": 240,
      "url": "https://www.youtube.com/embed/dQw4w9WgXcQ?start=91"
    },
    {
      "@type": "Clip",
      "name": "3 bước tối ưu AEO đầu tiên",
      "startOffset": 241,
      "endOffset": 480,
      "url": "https://www.youtube.com/embed/dQw4w9WgXcQ?start=241"
    },
    {
      "@type": "Clip",
      "name": "Công cụ đo lường AI visibility",
      "startOffset": 481,
      "endOffset": 645,
      "url": "https://www.youtube.com/embed/dQw4w9WgXcQ?start=481"
    }
  ],
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": "https://schema.org/WatchAction",
    "userInteractionCount": 1500
  }
}

ISO 8601 Format for Duration

This is the field most commonly declared incorrectly:

Rule: P starts it, T separates days from hours/minutes/seconds. If there are no days — use PT followed by hours (H), minutes (M), and seconds (S).

Thumbnail Optimization for Video Rich Results

Google has stricter thumbnail requirements than you might expect:

Minimum dimensions:

• Recommended: 1280×720 (16:9)
• Minimum: 640×360
• Other ratios (4:3, 1:1) are accepted but will be cropped

Thumbnail content:

• Must be an actual frame from the video (not a promotional banner)
• Text overlays must not cover more than 30% of the image area
• Must match the video content — Google checks this
• Avoid clickbait thumbnails (fake surprised faces, random arrows)

Technical requirements:

• Host the image on the same domain as the website (avoid third-party CDN when possible)
• Stable URL — do not change the thumbnail URL after indexing
• Declare width and height in ImageObject if using an object instead of a URL string

Implementation in Next.js App Router

// app/[lang]/blog/[slug]/page.tsx
import { type VideoObject, type WithContext } from "schema-dts";

function generateVideoSchema(video: VideoData): WithContext<VideoObject> {
  return {
    "@context": "https://schema.org",
    "@type": "VideoObject",
    "@id": `${siteUrl}/blog/${video.slug}#video`,
    name: video.title,
    description: video.description,
    thumbnailUrl: video.thumbnailUrl,
    uploadDate: video.uploadDate,
    duration: video.duration, // ISO 8601
    embedUrl: video.youtubeEmbedUrl,
    author: {
      "@type": "Person",
      "@id": `${siteUrl}/tac-gia/${video.authorSlug}`,
      name: video.authorName,
    },
    publisher: {
      "@type": "Organization",
      "@id": siteUrl,
      name: "AEO Saigon",
    },
    dateModified: video.dateModified,
    inLanguage: lang,
    ...(video.clips && {
      hasPart: video.clips.map((clip) => ({
        "@type": "Clip" as const,
        name: clip.name,
        startOffset: clip.start,
        endOffset: clip.end,
        url: `${video.youtubeEmbedUrl}?start=${clip.start}`,
      })),
    }),
  };
}

Testing VideoObject Schema

Required tools:

1. Rich Results Test — checks whether the video qualifies for rich results, shows specific errors and warnings

2. Schema Markup Validator — validates JSON-LD syntax, detects format errors

3. Google Search Console — the "Video" section under Enhancement reports, shows which videos have been indexed and any issues

Common errors:

Video on Landing Pages vs Blog Posts

VideoObject schema works best when:

Landing page (one main video):

• Video explaining a product/service → standalone VideoObject
• Combine with Product or Service schema via subjectOf
• Thumbnail = most impactful frame, not a logo

Blog post with attached video:

• Article = Article schema, video = VideoObject schema
• Link via: Article video → VideoObject
• Video should complement the article, not just be an embedded YouTube for show

FAQ page with video answers:

• FAQPage schema + VideoObject in each Answer
• This is a format AI search particularly favors — question + video answer

The clearer the video's structure (chapters, timestamps, transcript), the easier it is for AI to cite and display it. VideoObject schema is the first step — after that, it comes down to the actual quality of the content in the video.

Frequently asked questions