Video Schema on Shopify: Markup, Watch Pages and Validation

Video Schema on Shopify: Markup, Watch Pages and Validation

Use VideoObject structured data to describe a visible video accurately. Markup alone does not guarantee indexing or video results. A product page with a supplementary review video is different from a dedicated watch page, where watching one video is the main purpose.

What to check: describe the actual video, use supported media properties, preserve existing product markup, and validate the rendered page. Treat Peers video collection and search markup as separate tasks.

Trypeers
Add Authentic Video To Product Pages
Peers helps Shopify brands embed authentic post-purchase video reviews and shopper Q&A directly on product pages, supporting more confident purchases.
Visit Peers

Table of Contents

Video markup and watch-page eligibility

Google’s video SEO guidance distinguishes dedicated watch pages from pages where video is supplementary. A product page with a review clip is generally in the second category. Do not promise video search features merely because a product page has JSON-LD.

Use descriptive page copy and a player shoppers can access. If you create a dedicated watch page, give it a useful purpose and its own accurate title. Do not create empty pages solely to chase a search appearance.

Google’s VideoObject documentation lists name, thumbnailUrl and uploadDate as required properties. contentUrl or embedUrl is recommended so Google can access the content; use the correct kind of URL. A description and duration can add useful detail.

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Example product demonstration",
  "thumbnailUrl": "https://example.com/replace-with-real-thumbnail.jpg",
  "uploadDate": "2026-01-10T12:00:00Z",
  "contentUrl": "https://example.com/replace-with-real-video.mp4"
}

This is an illustrative structure, not ready-to-paste data. Replace every example value with verified information about the visible video. Validation does not guarantee a search result.

Map Shopify media accurately

Map properties according to media type. Shopify-hosted video exposes sources, preview_image and duration in milliseconds. external_video exposes a host and external ID instead.

Do not assume both objects expose the same fields or a created_at property. Maintain an accurate first-publication timestamp separately when Liquid does not provide it. Do not substitute the product creation date or invent a date. Encode strings with Liquid’s JSON filter, and convert a known duration into ISO 8601 format.

Validate the actual page

  1. Inspect the rendered page and confirm its visible video matches the markup.
  2. Use Google’s Rich Results Test and the Schema Markup Validator to inspect supported types and syntax.
  3. Check that media and thumbnail URLs load, are accessible to crawlers, and match the described content.
  4. Use Search Console after release to distinguish discovery, indexing and video eligibility.

JSON-LD may be server-rendered or generated with JavaScript. Check what Google can render instead of treating server-side output as an eligibility requirement.

Preserve product markup

Shopify’s structured_data filter emits product information, including ProductGroup for products with variants. Preserve valid output while adding video information. Do not disable product markup merely because another app emits a separate block.

Multiple structured-data blocks are not automatically invalid. Check for contradictory values and duplicate descriptions of the same entity. Nesting VideoObject through Product.subjectOf is not a mandatory Google video requirement.

Maintain review-video metadata

Keep permission, purchase context and video metadata as separate records. A purchase-verification label does not establish reuse rights, and neither guarantees search eligibility. When a video is replaced or removed, review any related markup as part of the same change.

Where Peers fits

Peers collects and displays customer video reviews and shopper Q&A. VideoObject markup and search eligibility are separate implementation tasks; verify the actual output of your theme and apps. Do not assume Peers automatically generates or exports video schema.

Trypeers

Where to start and what to check on a schedule — overview diagram

A practical rollout

Start with one page and one video. Record the intended behavior, inspect the existing markup and validate the change before expanding it. Recheck after a theme update, app change or media replacement. Track actual search and shopper behavior rather than assuming markup creates a conversion lift.

FAQ

What is video schema?

VideoObject describes a video in machine-readable form. It complements a working player and useful page content.

Which properties should I check?

Follow the current required and recommended properties in Google’s documentation, using real values for the visible video.

Does my store already emit video markup?

Inspect the output of your theme and apps. Product markup and video markup are separate; do not assume one includes the other.

How do I validate a change?

Test the rendered page, validate the markup and review Search Console. A passing syntax check does not guarantee indexing or a video result.

Can a review video be described with VideoObject?

Yes, when the description is accurate and the video is visible. Page purpose, access and permission still matter.

Sources