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
| Step | What 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
| Feature | What 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.
- Purchase access with the button above, then log in and download the ZIP. One purchase covers as many of your sites as you like.
- In Joomla admin, go to System โ Install โ Extensions and upload the ZIP. The plugin is switched on for you.
- Open an article with a video and check it with Google's Rich Results Test. It should list the video.
- 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.

Add comment