Description
Video Player Block adds a lightweight, fully customizable HTML5 video player to the WordPress block editor (Gutenberg). Add the block, pick a video and publish: no shortcodes, no page builder and no external libraries.
Every setting lives in a clean sidebar with two tabs: General for what the video player does and Style for how it looks. The editor preview runs the same player your visitors see, so what you design is what gets published.
Use it for course lessons, product demos, tutorials, testimonials, background-free hero videos or a complete video playlist.
Why use this video player block?
- Fast – the player script loads only on pages that contain the block, and it has no external dependencies.
- Responsive – the video player and its playlist adapt to desktop, tablet and mobile screens.
- Privacy-friendly – YouTube and Vimeo videos load nothing from the provider until the visitor presses play.
- Accessible – keyboard shortcuts, labelled buttons and screen-reader friendly sliders.
- Theme friendly – styles are scoped to the player, so they never clash with your theme.
Free features
- HTML5 video player block for any Media Library video or direct video URL (MP4, WebM, MOV…)
- The browser’s built-in video controls
- Show controls, autoplay, muted, loop, play inline and preload options
- Width, height, corner radius and video fit
- Admin dashboard with live demos, feature comparison and step-by-step documentation
Pro features
Everything below is part of Video Player Pro. Pro options are marked “Pro” in the editor; see the Feature Comparison page in the plugin dashboard.
Video sources
- Media Library uploads or any direct video URL (MP4, WebM, MOV…)
- Video playlists with titles, descriptions, thumbnails and durations
- YouTube video player and Vimeo video player, loaded privacy-friendly (click to load)
- Multiple quality sources (for example 1080p / 720p / 480p) with seamless switching
Player features
- Modern custom control bar, or the browser’s native controls
- Choose which buttons appear: play, rewind/forward, progress, time, mute, volume, captions, settings, picture-in-picture, fullscreen and download
- Playback speed menu with selectable speeds and a default speed
- Subtitles and closed captions (WebVTT) with a language menu and styleable captions
- Custom poster image and title overlay
- Start and end time (play only part of a video)
- Automatic muted fallback when the browser blocks autoplay with sound
- Keyboard shortcuts (Space/K, arrows, M, F, C, I, 0–9, < >)
- Click to play, double-click for fullscreen, auto-hiding controls
- Floating mini player when scrolling away from a playing video
- Pause other players when one starts; optional pause when scrolled out of view
- Resume where the viewer left off (stored in the visitor’s browser only)
- End screen with Replay and a call-to-action button
- Logo or text watermark with optional link
- Discourage downloads (hides the browser download option and right-click menu)
- Playback events for analytics: a
cpvp:eventDOM event, and optional Google Tag ManagerdataLayerpushes
Video playlist
- Playlist on the right, left or below the video
- Auto-advance to the next video and repeat the playlist
- Thumbnails, titles, descriptions and durations for every item
- Playlists stack automatically under the video on narrow screens
Styling
- Typography controls (Google Fonts, weight, responsive size, style, transform, decoration, line height, letter spacing) for the control bar, title, captions and playlist
- Solid, gradient or image backgrounds for the container, video area, control bar and playlist
- Responsive width, height, padding and margin for desktop, tablet and mobile
- Aspect ratio presets (16:9, 21:9, 4:3, 1:1, 9:16 and more) and video fit
- Border (width, style, color, sides, per-corner radius) and multiple box shadows
- Control bar, progress bar, volume, play button (shape, size, hover colors), captions and title styling
- Playlist size, colors, hover and active states, thumbnail size and radius
Privacy
This plugin uses the Freemius SDK for license activation and updates. Freemius receives data about your site only after you opt in or activate a license; see https://freemius.com/privacy/ for details. Visitors of your site are never tracked by the plugin.
Installation
- In your WordPress dashboard go to Plugins → Add New Plugin and search for “Video Player Block”.
- Install and activate the plugin.
- Open a post or page in the block editor, click the “+” inserter and search for “Video Player”.
- Choose a video from the Media Library or paste a video URL, then publish.
To install manually, upload the plugin folder to /wp-content/plugins/ and activate it through the Plugins screen.
FAQ
How do I add a video player to a WordPress page?
Open the page in the block editor, add the Video Player block from the inserter and pick a video from the Media Library or paste a video URL. The block works in posts, pages and the Site Editor.
Does the video player work with any theme?
Yes. Styles are scoped to the player so they do not conflict with your theme, and it works with block themes and classic themes.
Is the video player responsive on mobile?
Yes. The player resizes with its container, and width, height, padding and margin can be set separately for desktop, tablet and mobile.
Can I use external video URLs?
Yes, paste any direct video file URL (MP4, WebM, MOV…). YouTube and Vimeo links are supported through their own players.
Can I create a video playlist?
Yes, with Pro. Add several videos with titles, thumbnails and descriptions; the playlist can sit beside or below the video and auto-advances to the next video.
How do I add captions or subtitles?
Upload a WebVTT (.vtt) file to the Media Library (or host it elsewhere with CORS enabled) and add it under General → Subtitles & Captions.
Will my existing videos change after updating?
No. Videos created with version 1.0.0 keep their exact output on your site. When you next edit such a post, the block is upgraded automatically and keeps the browser’s native controls so it looks the same. Switch to the Custom skin under General → Player Controls to use the new features.
What is free and what is Pro?
Free gives you an HTML5 video player block with the browser’s controls and the basic playback and size options. Pro adds playlists, YouTube and Vimeo, the custom control bar and all player features, and the complete Style tab. Open Video Player → Feature Comparison in your dashboard for the full list.
What happens to my Pro settings if my license expires?
They stay saved in your posts, but the Pro features lock and the page shows the free player. Renew or reactivate the license and everything comes back.
Does the plugin track my visitors or contact external services?
No. Self-hosted videos never contact external services. YouTube/Vimeo content (and the YouTube thumbnail) is only loaded from the provider when you use those sources. If you pick a Google font in a Typography setting with “Load Google Font” on, that font is loaded from fonts.googleapis.com; turn the option off to use a font that is already on your site. “Resume where the viewer left off” stores the playback position in the visitor’s own browser (localStorage).
Screenshots











Changelog
2.0.0
- New: Updated flexible pricing plans for Single Site, 5 Sites, and Unlimited Sites with monthly, annual, and lifetime options.
- New: Promotional banner support for special offers and discounts.
- Improved: Overall dashboard performance, stability, and UI improvements.
1.1.0
- New: General / Style sidebar tabs with organized, collapsible panels.
- New: custom control bar with speed, quality, captions, picture-in-picture, fullscreen and download buttons.
- New: video playlists with auto-advance, repeat and responsive layouts.
- New: YouTube and Vimeo sources with a privacy-friendly click-to-load facade.
- New: quality sources, WebVTT captions, poster, title overlay, start/end time, default speed and volume.
- New: keyboard shortcuts, floating mini player, pause other players, pause off-screen, resume playback.
- New: end screen with call to action, logo/text watermark, download protection, analytics events.
- New: admin dashboard with Welcome, Demo, Feature Comparison, Pricing and Documentation pages.
- New: Pro version with license activation (Freemius). Pro features are marked in the editor and open an upgrade window.
- New: complete styling options including responsive sizes and spacing, aspect ratios, colors, gradient/image backgrounds, borders, shadows and typography with Google Fonts.
- Fix: fixed-width videos no longer overflow on phones in block themes.
- Fix: the “Video source not set” box no longer overflows on narrow screens.
- Existing 1.0.0 blocks remain valid and render unchanged.
1.0.0
- Initial release.
