Story Video Block

Story Video Block is a block-editor (Gutenberg) video embed block. It pairs a video with a heading, description, and attribution, so it works just as well for a video testimonial or story-style layout as it does as a standalone video player — the “Video only” layout drops the text entirely for a clean, full-width embed.

Unlike most video blocks, nothing is shipped to visitors just to swap a poster image for a video player: the click-to-play interaction runs on WordPress’s native @wordpress/interactivity module — no React, no jQuery, no extra framework loaded on the front end.

Features

• One field, auto-detected — paste a URL from YouTube, Vimeo, Dailymotion, Facebook, Twitch, Wistia, Loom, TikTok, VideoPress, or a self-hosted .mp4/.webm/.ogg/.mov file. The provider and video ID are detected automatically.
• Poster image — auto-pulled from YouTube, Dailymotion, and Loom, or upload your own for any provider.
• Click-to-load playback — no video player loads until the visitor clicks play, keeping the page fast.
• No React, no jQuery on the front end — the click-to-play interaction runs on WordPress’s native @wordpress/interactivity module (a script module, not a classic script), not a framework. Nothing is shipped to visitors just to swap a poster image for a video embed.
• Configurable play button — 4 built-in icon shapes x 3 color styles, and extendable via WordPress filters if you want to bring your own icon library.
• Testimonial mode — swap the heading/description for a quote, author name, author title, and avatar.
• Video only mode — use it as a standalone video player: drops the heading, description, and testimonial content for a full-width embed, with an optional fixed height for consistent-sized players.
• Media position — video on the left or right of the content.
• Card style — standard, or an “overlapping media” look where the video pokes out above/below the card.
• Background & text color controls, plus CSS custom properties for everything else (padding, gap, radius, shadow, play-button colors, and more) so a theme can restyle the block without editing plugin files.
• Transcript upload — attach a PDF/Word/text file for accessibility; renders as a labeled download link.
• Developer filters — story_video_block_css_vars and story_video_block_content let a theme or must-use plugin adjust the block’s frontend CSS/markup from functions.php.
• Accessible by default — labeled controls, aria-labels on interactive elements, decorative images marked as such, and visible “opens in a new tab” hints for screen readers.