Skip to main content
Cybersalt Consulting Ltd
Joomla extension

Video Schema

Video results in Google for your Vimeo and YouTube articles

ProJoomla 5Joomla 6 v1.0.0
$9.95/year

A yearly subscription for downloads and updates.

Buy Video Schema

Video Schema is a paid Joomla 5 / 6 extension that tells Google about the Vimeo and YouTube videos in your articles, so those pages can show up as video results. Editors don't do anything new: they paste the embed into the article as usual, and the plugin finds it, looks up the video's title, description, thumbnail, length and upload date, and adds them to the page as schema.org VideoObject data.

Why this exists

Google only shows a page as a video result when the page describes its video in structured data. Joomla's own schema.org plugins have no video type, and SEO extensions generally only pick up video files you host yourself, not a Vimeo or YouTube embed. The usual workaround is a custom field per article that someone has to fill in, which gets forgotten. This plugin reads the embed that's already in the article, so every video article is covered, including the ones written years ago.

How it works

StepWhat happens
Finds the videos On a single-article page it looks for player.vimeo.com/video/โ€ฆ, youtube.com/embed/โ€ฆ and youtube-nocookie.com/embed/โ€ฆ embeds in the article text, unlisted Vimeo videos included. It also works when a cookie-consent or lazy-load extension has changed the embed.
Looks up the details Vimeo's and YouTube's own public information gives the title, description, thumbnail, length and upload date. Each video is looked up once and kept, then checked again every 7 days (a setting) and straight away when the article is saved.
Adds the data One VideoObject per video. When Joomla's System - Schema.org plugin is on, the videos join its data for the page, linked to it. Otherwise they're added as a block of their own.
Fills the gaps Google needs a name, thumbnail and upload date. If Vimeo or YouTube can't give one, for a private video for example, the article's title, description, image and publish date are used instead. A video that no longer exists is left out, so Google is never sent to a missing video.

The data is in the page's HTML itself. Vimeo's player adds its own video data in the visitor's browser, but crawlers that don't run JavaScript never see that. They see this.

What it can do

FeatureWhat you get
Vimeo and YouTube Both players, several videos per article, in any mix.
Nothing to set up The plugin switches itself on when it's installed. The defaults suit most sites.
Per-article control An optional Video Schema tab on the article form turns the data off for one article, or lists a video that shows on the page from somewhere else, such as a module.
Never breaks a page If Vimeo or YouTube is slow or down, the page goes out as normal, with the details fetched before or without the video data. No more than a few lookups happen on any one page view.
File check The settings page shows whether every installed file matches the release, so an update that didn't finish shows up straight away.
Languages 17 languages: English, Czech, Dutch, French, German, Greek, Italian, Japanese, both Norwegian written forms, Polish, Brazilian Portuguese, Russian, Simplified Chinese, Spanish, Swedish and Turkish.

Installing it

You'll need Joomla 5 or 6 and PHP 8.1 or later.

  1. Purchase access with the button above, then log in and download the ZIP. One purchase covers as many of your sites as you like.
  2. In Joomla admin, go to System โ†’ Install โ†’ Extensions and upload the ZIP. The plugin is switched on for you.
  3. Open an article with a video and check it with Google's Rich Results Test. It should list the video.
  4. Go to System โ†’ Manage โ†’ Plugins, open System - Cybersalt Video Schema, and on its Pro Activation tab enter the email address of your cybersalt.com account and save. New versions then arrive through Joomla's own System โ†’ Update โ†’ Extensions screen. The video data works whether or not a site is activated. Only the updates need a current membership.

Using it

There's nothing to do day to day. Add videos to articles the way you always have. The settings, under System โ†’ Manage โ†’ Plugins โ†’ System - Cybersalt Video Schema, are there for the unusual cases: how often video details are refreshed, whether to join Joomla's schema.org data, and whether to fill gaps from the article.

Google decides for itself which pages to show as video results, and it prefers pages where the video is the main content. The structured data makes a page eligible; it doesn't guarantee a video result.

Permissions and security

The plugin only describes published articles a visitor is allowed to see, and only talks to Vimeo and YouTube. It adds to the page's structured data and never changes the data other extensions put there.

Open source

Video Schema is licensed under GPL-2.0-or-later, the same license as Joomla itself. The full source is in the ZIP you download.

Please log in to download Cybersalt Video Schema.


Interesting blog? Like it on Facebook, Post it or share this article on other bookmarking websites.

Written by:
Tim Davis is the founder and owner of Cybersalt.

Recent changes

Version 1.0.0 19 Nov 2026

First release

  • Adds schema.org VideoObject data to article pages with a Vimeo or YouTube embed, found automatically in the article text.
  • Video details (title, description, thumbnail, length, upload date) are looked up once and cached, then refreshed on a schedule and whenever the article is saved.
  • Joins Joomla's own schema.org data when the System - Schema.org plugin is on; otherwise outputs its own JSON-LD block.
  • Fills Google's required fields from the article when the player can't supply them; videos that no longer exist are left out.
  • Optional Video Schema tab on the article form.
  • Pro Activation tab for updates through Joomla, and settings in 17 languages.

Add comment

Submit

Joomla websites built well and looked after properly, from Victoria, BC, Canada, since 1998.

About Cybersalt