Video Page Best Practices

Modified on Thu, 17 Oct at 10:59 AM

Video Pages pages are pages where a single video is the main content of that page. This Best Practices document is intended to support technical teams, and content creation teams. Our goal is to ensure the content and structure of your Video pages are optimized to align with Google’s best practices. Use this document as a checklist during the development and revision of HTML templates for pages with Video content. 


As always, if you have any follow-up questions, please contact support@schemaapp.com for guidance.



Typical Page Content

This section describes content commonly seen on this type of page. This checklist is best used during high level design & brainstorming as you design templates & decide what information you intend to display. It may also be helpful for evaluating potential CMS and video hosting solutions.


Typical Page Content

Description & Details

Typical Targeting Approach

Page Content
NameName or title of the WebPage that is the viewing page for the VideoVia Highlight
Author/Editor/PublisherThe author, editor, or publisher of the WebPageVia Highlight
Date Published/Date ModifiedThe date the WebPage was published, and the date it was last modified.Via Highlight

Accompanying TextMinimal on-page text describing and contextualizing the videoVia Highlight

Video PlayerAn HTML component containing the video itself. Schema App can use information from the Video Player and hosting platform to generate Schema Markup using the platform's API. For more information review the section on Video Integrations.Via Highlight
Video Metadata Content
NameThe name of the VideoVia API from CMS
PublisherThe publisher of the WebPage, typically pulling from the video hosting platform. This will reference the canonical URL of the Profile Page. Be sure to include this URL as a sameAs value in your Organization markup.Via API from CMS 
Date Published/Date ModifiedThe date the Video was published and/or last modified.Via API from CMS 
DescriptionThe description of the Video. If this content is not populated in the hosting platform CMS, then this property will not be populated in the JSON-LD.Via API from CMS 
Thumbnail URLThe thumbnail preview image for the video. Via API from CMS 


Video Integrations

oEmbed API Protocol

With the Highlighter tool, Schema App can generate VideoObject structured data using the oEmbed API protocol. A full list of providers can be found here. Notable providers include YouTube, Vimeo, and Wistia. No action is required from your Organization to provide Schema App with access as this is an open API protocol.


Note: changes to your video metadata can take up to 3 days to be reflected. This number can increase if there is significant site caching.


Auto-generated WordPress Markup

If a page is receiving auto-generated markup via the WordPress plugin, the oEmbed API protocol ought to generate VideoObject markup for any videos within the page content.


Brightcove API Protocol

If your organization hosts videos using Brightcove, we can generate VideoObject structured data from the Brightcove API. Your Organization must register an application for Schema App in order to provide us with access to your API. The instructions for registering a Brightcove application from within Schema App’s tools can be found here.


Content and Code Requirements

The following content and/or code requirements will support your Organizations's ability to target and include all the required information for Video Rich Result eligibility.


Video Content & Metadata in Your Content Management System

If there are videos in your CMS that are missing metadata that map to required Video Rich Result properties (e.g description, name) then those Video Pages will have errors and warnings in GSC and the Rich Results Test.


Content & Embed URLs

Google uses the content URL to fetch the video file and assess its audio and visual content. The URL must be stable, must be accessible via Robots.txt and have the required server capacity to be crawled. 


The content and embed URLs should be accessible within the HTML document. Nested #document data is inaccessible to the Schema App Highlighter. Special attention may be required for Brightcove, and other pages where the content/embedURLs are not present in an usable format.


Author/Editor/Publisher Content

Video Pages are typically published by the Organization that is the main entity of the website that the Video Pages are part of. The Organization can be defined using the Schema App Editor. If the Video Page does not contain text, authorship may not be required.



Video Page FAQs

Why all the fuss about a Video needing to be the “main content of page”? 

Since 2022 Google has made significant changes to how Videos are indexed, and displayed. From 2023, a key message  from Google has been to create dedicated pages where a Video is the primary entity of a page. Videos may appear on several pages such as a dedicated Video page, and a Product page where the video content is contextualized. Google uses various signals and structured sources to understand videos and Video Pages.


What signals does Google use to understand Video Pages?

Google uses a combination of on-page data (e.g HTML, structured markup) and user-submitted data (e.g video sitemaps). Google aims to understand the content of the video using on-page text, referring links, and schema markup. If the video file is accessible (and ideally it should be!) Google can also fetch and analyze video files to analyze their audio and visual content. 


What if my Video Page uses a third party embedded player?

If those Videos are embedded on your site, and the third party’s website (e.g YouTube), then Google may index that Video from both sources and both sources may show up in Google.


What happens when I have a video on several different pages?

Video Pages are critical to helping Google understand why videos may appear in different contexts. It is very normal for videos to appear in multiple places. Third party players, collection or item pages, and translated pages are all common scenarios where this might happen.


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article