How do you deploy and maintain video structured data?

ProcrustesPR

To deploy video structured data, first add VideoObject to pages where users can watch the video, include all required properties, and test the markup. Then confirm that Google can access and render the pages. After deployment, keep checking that the video, thumbnail, and markup remain consistent, and recheck them after updates. This helps Google find videos and understand their details, but does not guarantee that specific video features will appear in search results.

ProcrustesPRProcrustesPRHow Long Does It Take to Evaluate SEO Results?

Get the required properties right first, without treating recommended fields as requirements

Google’s video documentation lists the following required VideoObject properties:

  • name: The video’s title. Each video on the site should have a unique title.
  • thumbnailUrl: The URL pointing to the thumbnail image file specific to that video.
  • uploadDate: The date and time the video was first published, in ISO 8601 format. Including a time zone is recommended.

The documentation also recommends providing contentUrl whenever possible so Google can fetch the video file. If that is not possible, use embedUrl instead. These recommended properties should not be confused with required properties. The markup must also comply with Search Essentials, the general structured data guidelines, and the video indexing requirements.

Test a few pages first, then check how they actually render

Use the Rich Results Test to validate the code and fix all critical errors. Addressing non-critical issues is also recommended to improve data quality, but fixing them is not required for eligibility.

Next, deploy a few pages containing the markup and use the URL Inspection tool to check how Google renders them. Passing the code test does not mean the page can be accessed or indexed successfully. Also check whether robots.txt blocks crawling, whether a noindex directive is present, and whether the watch page requires users to sign in.

Allow time for crawling and indexing after submitting changes

Once the page checks out, you can ask Google to recrawl the URL and submit a sitemap to help Google keep track of subsequent changes. After publication, Google may take a few days to discover and crawl the page, and reindexing also takes time. The absence of video features should not immediately be taken as evidence that deployment has failed.

Focus maintenance on consistent content and complete mobile markup

When a video or page is updated, include the following in your checks:

  • Does the structured data still match the actual video content and remain consistent with other metadata?
  • Are each video’s thumbnail URL, name, and description specific to that video?
  • If both the sitemap and structured data specify a thumbnail, do they use the same thumbnail URL for the same video?
  • Do the mobile and desktop versions retain the same video structured data?

For example, when replacing a thumbnail, do not just update the image on the page; also check other metadata that specifies the thumbnail. Thumbnail URLs must be stable and accessible to Googlebot and Googlebot Images. Videos should also be easy to find on mobile. If users have to scroll a long way down to see a video, its ranking may be lower.

ProcrustesPRProcrustesPRWhere should I start if I want to do SEO myself?

Deploying and maintaining video structured data: perspectives from across the web

How can you check that video markup still works after a website redesign?

After major changes to templates or code, monitor valid and invalid items in Search Console’s rich result status reports. An increase in invalid items may indicate a problem with the new template or its interaction with the site. If valid items decrease without an increase in errors, pages may no longer include structured data; use the URL Inspection tool to investigate. After making fixes, test the live URL and request validation through the report.

What else can you check if the markup passes testing but video features do not appear?

First, check for structured data errors and review the Unparsable structured data report, then check the relevant guidelines. Issues such as spam or inappropriate markup may be unrelated to syntax and may not be detected by the Rich Results Test. If you receive a structured data manual action, make corrections according to the Manual Actions report. Structured data on the affected pages will be ignored, but the pages can still appear in search results.

How can you mark up and maintain key moments in videos?

For videos embedded on web pages or hosted on video platforms, you can use Clip to specify segment start and end times and labels. Alternatively, use SeekToAction to provide a URL pattern that includes a timestamp, allowing Google to identify segments automatically.

For either option, videos must support links that go directly to specific times, be at least 30 seconds long, and have VideoObject markup on a page where they can be watched. SeekToAction is available only in supported languages. Google itself also attempts to detect segments automatically.

How should structured data be updated when a livestream ends?

If a publicly accessible livestream uses BroadcastEvent to seek a LIVE badge, first update endDate in the page’s markup after streaming stops, then call the Indexing API to notify Google.

Using the LIVE badge requires both following its guidelines and using the Indexing API. Call the API when the video goes live, as well as when the markup changes and Google needs to be notified. This use of the API applies only to livestreamed videos.

ProcrustesPRShould I rewrite or update an old article that does not rank?

References

  1. 教育問與答結構化資料 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Discusses: How can you check that video markup still works after a website redesign?
  2. 雇主評分 (EmployerAggregateRating) 結構化資料 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Discusses: What else can you check if the markup passes testing but video features do not appear?
  3. 影片 (VideoObject、Clip、BroadcastEvent) 結構定義標記 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Discusses: How can you mark up and maintain key moments in videos?; How should structured data be updated when a livestream ends?
  4. 討論區 (DiscussionForumPosting、SocialMediaPosting) 結構定義標記 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Discusses: How can you check that video markup still works after a website redesign?
  5. 行動版內容優先索引系統的最佳做法 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Source used in the article above.
  6. 商家退貨政策結構化資料 (MerchantReturnPolicy) | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Discusses: What else can you check if the markup passes testing but video features do not appear?
  7. 影片搜尋引擎最佳化 (SEO) 最佳做法 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Source used in the article above.

Related articles

How Long Does It Take to Evaluate SEO Results?Where should I start if I want to do SEO myself?Should I rewrite or update an old article that does not rank?What should I check when organic traffic suddenly drops?Why can I not find my published article on Google?Will Reposting Social Content on My Website Cause a Duplicate-Content Penalty?Eight SEO essentials for beginners: Getting your pages indexedWhat Is SEO? Understanding Optimization Priorities Through How Search Engines Work
ProcrustesPR
ProcrustesPR