Help Center
< All Topics

VideoObject Schema Markup Setup Guide

Want your videos to show up in Google with thumbnails, duration, and key moments, or be better understood by AI tools and assistants? Adding VideoObject Schema Markup is essential. This guide will show you how to add Video Schema using the Schema Package WordPress plugin — to enhance search presence, improve click-through rates, and power AI discovery.

What Is VideoObject Schema Markup?

VideoObject Schema Markup is a structured data format defined by Schema.org that helps search engines and AI systems understand and index your video content — including title, description, upload date, duration, and more.

With VideoObject Schema, your content can appear in:

  • Google video-rich snippets (with thumbnail, duration, date, etc.)
  • Video carousels in search results
  • Google Discover and mobile search
  • AI-generated answers (e.g., Google SGE, ChatGPT, Bing Copilot)
  • Voice assistant responses and media recommendations

📘 Read Google’s official documentation here:
👉 Google Video Structured Data Guidelines

Why Use VideoObject Schema?

Adding Video Schema improves:

✅ Search Visibility: Videos appear with enhanced previews and video carousels
✅ AI Indexing: Enables AI tools to detect and rank your video content
✅ User Engagement: Rich results drive more clicks and longer dwell time
✅ Multimedia Discoverability: Essential for creators using YouTube, Vimeo, or self-hosted videos

When Should You Use VideoObject Schema?

Use VideoObject Schema for:

  • YouTube or embedded videos
  • Self-hosted videos on your site
  • Video tutorials, reviews, presentations, or webinars
  • Video landing pages or featured video blog posts

⚠️ Avoid using it on pages without a playable or embedded video. Schema must match actual content.

How to Set Up Video Schema in WordPress (Using Schema Package Plugin)

The Schema Package plugin lets you add VideoObject Schema in two flexible ways:

✅ Method 1: Apply VideoObject Schema Automatically (Global Setup)

  1. Go to Schema Package Dashboard → Singular Tab
  2. Click Add Schematrong

  3. Select Schema Type: VideoObject

  4. Set Targeting Rules (e.g., Post Type = Posts, Pages, or Video CPT)
  5. Map schema fields based on your post structure:
    • name → Post Title
    • description → Post Excerpt or Custom Field
    • uploadDate → Publish Date or Custom Field
    • thumbnailUrl → Featured Image or video thumbnail
    • contentUrl → Video file or embed URL
    • embedUrl → YouTube/Vimeo embed link (optional)
    • duration → Custom Field (ISO 8601 format, e.g., PT2M30S)
    • publisher.name → Site Name or Author
    • publisher.logo → Site Logo URL
  6. Click Save to apply schema automatically across selected post types

💡 Note: This setup works great if your video content is structured consistently — especially when using ACF or similar custom fields.

✅ Method 2: Add Video Schema Manually Per Post (Schema Package Generator)

Use this method for more control over schema on individual video posts.

  1. Open the relevant post or page in the WordPress editor
  2. Scroll to the Schema Package Generator section
  3. Click Choose Schema Type, select VideoObject, and click Select



  4. Click the Edit icon next to the Video schema to open the field editor

  5. Fill in all relevant details:
    • Video Title
    • Description
    • Upload Date (YYYY-MM-DD or YYYY-MM-DDTHH:MM)
    • Video URL / Embed URL
    • Thumbnail URL
    • Duration (PT2M, PT1H30M, etc.)
    • Publisher Name & Logo URL
  6. Click Save for Post, then Update or Publish the post


⚠️ Note: The video must be publicly viewable and playable on the page. Google does not show schema-enhanced results for inaccessible or private videos.

Test Your Video Schema Markup

After adding the schema, validate it to ensure it’s properly structured:

Paste your post URL or HTML snippet to confirm that your video schema is valid.

Common Issues & Fixes

🛠️ Missing thumbnail or video URL — These are required for video-rich results
🛠️ Incorrect duration format — Use ISO 8601 (PT2M10S, PT1H)
🛠️ Video not visible — Schema only applies if the video is playable on the page
🛠️ Duplicate markup — Avoid overlapping schema from themes or other plugins

Final Thoughts

By adding VideoObject Schema using the Schema Package plugin, you ensure your video content is not only SEO-optimized but also future-ready for AI systems and voice search platforms. Whether you’re embedding YouTube tutorials or uploading your own videos, structured data helps you rank, engage, and get discovered.

Structured data is your video’s backstage pass to Google and AI.

👉 Start using Video Schema today to boost your video visibility, traffic, and AI discoverability.

Table of Contents