Video SEO
Gets your videos into Google's video results: finds every YouTube, Vimeo and self-hosted video, adds VideoObject schema with key moments, and builds a video sitemap automatically.
Screenshots
Video SEO gets your videos into Google’s video results automatically. It finds every YouTube, Vimeo and self-hosted video on your site, adds the structured data Google needs to understand them, and builds a video sitemap, with no setup per post. Most sites with videos have none of this, so their videos never show up in video search, the Videos tab, or with a thumbnail beside a regular result.
As soon as it’s activated, the plugin scans your posts, pages and custom post types in the background, and after that each post is checked whenever it’s saved. It reads the block editor, the classic editor, shortcodes and the saved layouts of page builders like Elementor, Divi, Beaver Builder, Bricks, Oxygen and WPBakery. Only embedded videos count: a plain link to a YouTube video, or a video address in the middle of a sentence, isn’t a video on the page, so it gets no schema.
Each video gets VideoObject schema with its title, description, thumbnail, upload date, duration, embed URL and view count. Details come straight from YouTube (with a free YouTube Data API key that takes about five minutes to set up) and Vimeo, and length and size are read from your own video files. When a description lists chapters like “0:00 Intro”, they become key moments, so Google can show jump-to-section links in results, and each link starts the video at that moment on your page.
If you use Yoast SEO, Rank Math or All in One SEO, the videos join that plugin’s schema instead of adding a second block of markup, and a video it already describes is filled in rather than repeated. The video sitemap lives at /video-sitemap.xml, updates by itself as videos are added or removed, and is listed in robots.txt and in your SEO plugin’s sitemap index, ready to submit in Search Console. Private, deleted and embed-blocked videos are left out and flagged.
Google only shows a video result when the video is the main thing on the page. The main content check flags pages where a video sits under a long article or after a lot of text, so you know which pages can realistically earn one. In the editor, a Video SEO panel shows each video’s details, its key moments and this check, and lets you change a video’s title, description and thumbnail for that page, add a transcript to the schema and optionally show it on the page, or leave a video out.
Optional lightweight embeds show a thumbnail and play button until someone clicks, so YouTube and Vimeo scripts don’t slow the page. By default each page’s main video stays a real player, because Google needs to see one. The video report lists every video on your site, the pages it’s on, its schema status and any missing details. Video SEO is free, with no Pro tier.
Features
- Finds every video. YouTube, Vimeo and self-hosted videos in posts, pages and custom post types, including blocks, the classic editor, shortcodes and page builders.
- VideoObject schema. Title, description, thumbnail, upload date, duration, embed URL and view count for every video, with no setup per post.
- Details pulled for you. From YouTube with a free YouTube Data API key, from Vimeo, and length and size read from your own video files.
- Key moments. Chapter timestamps in a video's description become Clip markup, so Google can show jump-to-section links. Each one starts the video there.
- A video sitemap. Updates as videos are added or removed, and is listed in robots.txt and your SEO plugin's sitemap index, ready for Search Console.
- Main content check. Flags pages where Google is unlikely to show a video result because the video isn't the main focus of the page.
- Per-video changes. Change a video's title, description and thumbnail for one page from a panel in the editor's sidebar, or leave it out.
- Lightweight embeds. An optional click-to-play preview keeps YouTube and Vimeo scripts off the page until someone presses play.
- Transcripts. Add a transcript to a video's schema, and show it under the video in a collapsible box if you like.
- A report of every video. Every video on the site, the pages it's on, its schema status and any missing details, with filters and search.
- Plays well with SEO plugins. Adds to the schema of Yoast SEO, Rank Math and All in One SEO instead of creating duplicate markup. Works with SEOPress too.
- Free, with no Pro tier. Every feature is in the free plugin. The YouTube API key is free as well, and the plugin uses a tiny part of its daily quota.
- Click Download above to save
video-seo.zip. Leave it zipped. - In your WordPress dashboard, go to Plugins > Add New Plugin and click Upload Plugin.
- Choose the ZIP and click Install Now, then Activate Plugin.
To update later, upload a newer ZIP the same way. WordPress offers to replace the installed version and keeps your settings.
Do I Need a YouTube API Key?
No, but it's worth the five minutes. Without a key, YouTube only shares a video's title and thumbnail, so the upload date falls back to the day the post was published and the duration and description are missing. With a free key from Google Cloud, every YouTube video gets its real upload date, duration, description, view count and chapters. The settings page walks you through getting one, and Video SEO uses a single unit of the 10,000-unit daily quota for every 50 videos.
Why Isn't My Video Showing in Google's Video Results?
Since late 2023, Google only shows a video result when the video is the main content of the page. A video placed under a long article usually won't get one, however good its schema is. The Pages tab flags those pages so you can decide whether to move the video up or give it a page of its own.
Will This Create Duplicate Schema with Yoast or Rank Math?
No. With Yoast SEO, Rank Math or All in One SEO active, the videos are added to that plugin's own schema graph and linked to its WebPage. If the SEO plugin already describes the same video, Video SEO fills in the missing details instead of adding a second VideoObject.
Which Videos Does It Find?
YouTube (including Shorts and youtube-nocookie embeds), Vimeo (including private links with a hash), and video files such as MP4 and WebM, in the block editor, the classic editor, shortcodes and page builders' saved layouts. Plain links to videos aren't counted, because a link isn't a video on the page.
How Do Key Moments Work?
If a video's description has three or more lines starting with a time, like "0:00 Intro", beginning at 0:00, each becomes a key moment in the schema. You can add or edit them per page from the editor panel. Each key moment links to your page with the start time, and the video starts there.
Will the Lightweight Embeds Hurt My Rankings?
Not with the recommended setting. Google needs to see a real player to show a video result, so by default each page's main video loads normally and only the other videos get the click-to-play preview. You can preview every video if speed matters more than video results on your site.
Does It Slow Down My Site?
No. Scanning and fetching video details happen in the background and when posts are saved, never while a visitor waits. Pages without videos run no extra database queries, and a page with videos adds one small query.
- See https://github.com/jmsprsns/video-seo/releases for the full release history.
Download
More Free WordPress Plugins
Honest Last Modified Date
Only changes a post's "Last modified" date when enough of it has really changed: a minimum number of words, a percentage, or both, set separately for posts and pages.Thumbnail Size Manager
See every image size your site makes, where each one came from, how many files it has and whether anything uses it. Switch off the sizes you don't need, clean up their files after a dry run, and regenerate the rest.Phone Click Tracking
See which pages, traffic sources and campaigns make people call or text you. Every tel:, sms:, WhatsApp and email click is logged in WordPress, with Google Business Profile and AI referrals, a Google Ads conversion export and client reports.Let's Grow Your Business
Want some free consulting? Let's hop on a call and talk about what we can do to help.
