VideoObject Schema – Video Content & Rich Results

VideoObject schema describes video content with technical details, metadata, and contextual information, enabling rich video results in search engines and helping users discover video content through enhanced search features.

Everything you need to know about VideoObject schema markup. Learn how to optimize video content for search engines, improve video discoverability, and enable rich video results.

What is VideoObject Schema?

VideoObject schema provides comprehensive metadata for video content, including technical specifications, content description, thumbnails, and contextual information. It's essential for video SEO and enables search engines to display rich video results with play buttons, duration, and view counts.

Why VideoObject Schema Matters

Video content is exploding, but without VideoObject schema, your videos remain invisible in search results. With proper markup, search engines can display video thumbnails, play buttons, and rich metadata directly in search results, significantly improving video discoverability and engagement.

The key insight: VideoObject schema transforms your video content from passive media files into interactive, searchable experiences that users can preview and engage with directly from search results. For video tutorials, combine with HowTo schema for step-by-step instructional content.

What VideoObject Schema Includes

•Technical video properties (duration, format, resolution)
•Content metadata (title, description, thumbnail)
•Engagement metrics (views, likes, upload date)
•Context and relationships (associated content, series)

SEO Benefits You Get

🎬Video rich results with thumbnails and play buttons
📈Higher click-through rates from engaging previews
🎯Better video search visibility and discoverability
📊Enhanced video analytics and performance tracking

JSON-LD Example

VideoObject schema for a product review video:
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "@id": "https://example.com/videos/canon-eos-r5-review",
  "name": "Canon EOS R5 Professional Camera Review - 8K Video & Photography",
  "description": "Complete review of the Canon EOS R5 professional mirrorless camera. We test 8K video recording, 45MP photos, autofocus performance, and real-world usage for professional photographers and videographers.",
  "thumbnailUrl": "https://example.com/videos/thumbnails/canon-eos-r5-review.jpg",
  "uploadDate": "2024-01-20T14:30:00-08:00",
  "duration": "PT15M30S",
  "contentUrl": "https://example.com/videos/canon-eos-r5-review.mp4",
  "embedUrl": "https://example.com/embed/canon-eos-r5-review",
  "interactionStatistic": [
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/WatchAction",
      "userInteractionCount": 15420
    },
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/LikeAction",
      "userInteractionCount": 892
    }
  ],
  "regionsAllowed": ["US", "CA", "GB", "DE", "FR", "AU"],
  "videoQuality": "HD",
  "width": 1920,
  "height": 1080,
  "bitrate": "8000",
  "videoFrameRate": "30",
  "caption": "https://example.com/videos/captions/canon-eos-r5-review.vtt",
  "transcript": "https://example.com/videos/transcripts/canon-eos-r5-review.html",
  "hasPart": [
    {
      "@type": "Clip",
      "name": "8K Video Test Results",
      "startOffset": 180,
      "endOffset": 420,
      "url": "https://example.com/videos/canon-eos-r5-review.mp4?t=180"
    },
    {
      "@type": "Clip",
      "name": "Autofocus Performance Demo",
      "startOffset": 600,
      "endOffset": 780,
      "url": "https://example.com/videos/canon-eos-r5-review.mp4?t=600"
    }
  ],
  "director": {
    "@type": "Person",
    "name": "Mike Chen",
    "jobTitle": "Senior Product Reviewer",
    "worksFor": {
      "@type": "Organization",
      "name": "TechReview Pro"
    }
  },
  "actor": [
    {
      "@type": "Person",
      "name": "Sarah Martinez",
      "jobTitle": "Professional Photographer"
    }
  ],
  "producer": {
    "@type": "Organization",
    "name": "TechReview Pro",
    "url": "https://techreviewpro.com"
  },
  "productionCompany": {
    "@type": "Organization",
    "name": "TechReview Pro",
    "url": "https://techreviewpro.com"
  },
  "about": [
    {
      "@type": "Product",
      "name": "Canon EOS R5",
      "brand": {
        "@type": "Brand",
        "name": "Canon"
      },
      "category": "Digital Cameras"
    },
    {
      "@type": "Thing",
      "name": "Professional Photography",
      "description": "High-end digital photography and videography equipment"
    }
  ],
  "mentions": [
    {
      "@type": "Product",
      "@id": "https://example.com/products/canon-eos-r5"
    }
  ],
  "isPartOf": {
    "@type": "VideoObject",
    "@id": "https://example.com/series/camera-reviews-2024",
    "name": "Camera Reviews 2024",
    "description": "Comprehensive reviews of the latest professional cameras"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": "https://example.com/videos/canon-eos-r5-review"
  },
  "publisher": {
    "@type": "Organization",
    "@id": "https://example.com/#organization"
  },
  "author": {
    "@type": "Person",
    "@id": "https://example.com/authors/mike-chen"
  },
  "datePublished": "2024-01-20",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "ratingCount": "234",
    "bestRating": "5",
    "worstRating": "1"
  },
  "review": {
    "@type": "Review",
    "author": {
      "@type": "Person",
      "name": "Mike Chen"
    },
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "4.5",
      "bestRating": "5"
    },
    "reviewBody": "The Canon EOS R5 delivers exceptional 8K video quality and professional photo capabilities..."
  }
}

Breaking Down the Structure

Core Video Properties:
  • @type: Must be "VideoObject"
  • name: Video title
  • description: Detailed video summary
  • duration: ISO 8601 format (PT15M30S)
Technical & Content:
  • contentUrl: Direct video file URL
  • embedUrl: Embeddable player URL
  • thumbnailUrl: Preview image URL
  • uploadDate: Publication timestamp

Practical Use Cases

📹 Product Review Videos

Product review and unboxing videos use VideoObject schema to showcase features, demonstrate usage, and provide rich previews that drive traffic to product pages.

Example: A camera review video includes VideoObject schema with timestamps for key sections (8K demo, autofocus test), view counts, and links to purchase pages.

Impact: Video rich results appear in search with play buttons and duration, significantly increasing click-through rates compared to text-only results.

🎓 Educational & Tutorial Videos

Educational content, tutorials, and how-to videos benefit from VideoObject schema to provide structured learning experiences with timestamps and related content.

Example: A coding tutorial video includes VideoObject schema with chapter markers for different sections (setup, basic syntax, advanced features) and links to code examples.

Impact: Students and learners can quickly navigate to relevant sections, improving engagement and completion rates for educational content.

📰 News & Current Events Videos

News organizations and current events coverage use VideoObject schema to provide timely, rich video results with publication dates and contextual information.

Example: A breaking news video includes VideoObject schema with upload timestamps, geographic restrictions, and links to related articles and live updates.

Impact: Time-sensitive content appears prominently in search results with clear publication information, helping users find the most current coverage.

Common Mistakes & How to Avoid Them

❌ Wrong Duration Format

Mistake: Using plain text like "15 minutes" instead of ISO 8601 duration format for the duration property.

Fix: Always use ISO 8601 format: "PT15M30S" for 15 minutes 30 seconds, "PT1H30M" for 1 hour 30 minutes. This ensures search engines parse durations correctly.

❌ Missing Video URLs

Mistake: Not including contentUrl or embedUrl, or using URLs that don't actually serve video content.

Fix: Provide direct video file URLs for contentUrl and embeddable player URLs for embedUrl. Ensure URLs are accessible and serve the correct content type.

⚠️ Inaccurate Upload Dates

Mistake: Using wrong or inconsistent upload dates that don't match when the video was actually published.

Fix: Use accurate, consistent timestamps in ISO 8601 format. Ensure uploadDate matches the actual publication time for proper freshness signals.

⚠️ Missing Video Thumbnails

Mistake: Not providing thumbnailUrl or using low-quality, generic thumbnails that don't represent the video content.

Fix: Include high-quality, representative thumbnail images that clearly show what the video contains. Thumbnails should be visually appealing and informative.

SEO Tip: Video Series & Playlists

For video series or playlists, use the isPartOf property to connect individual videos to a larger collection, improving discoverability and user engagement.

Video Series
Connect episodes to a show
Playlists
Group related content

Validate Your VideoObject Schema

Test your VideoObject schema implementation to ensure proper video metadata and rich results eligibility.

Test with SchemaValidator

Our comprehensive validation tool

Google Rich Results Test

Official Google testing tool

Related Schema Types

VideoObject schema works with these related schemas for comprehensive video content representation.

Article Schema

For video articles and multimedia content

Product Schema

For product review and demo videos

Person Schema

For video creators and talent

← Back to Schema Types