Media · Gutenberg
Video Grid block for WordPress
Responsive grid of video cards with play-in-lightbox functionality. Supports YouTube, Vimeo, and self-hosted videos. Custom thumbnails, titles, and duration badges.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
Responsive grid of video cards with play-in-lightbox functionality. Supports YouTube, Vimeo, and self-hosted videos. Custom thumbnails, titles, and duration badges.
Inspector panels on this block: Videos, Layout, Display, Appearance. Those titles come from index.js, not from a shared template.
Where to find it
Gutenberg inserter → Media → search “Video Grid” (block name `blockenberg/video-grid` in block.json). Style it in the sidebar after insert.
How to use Video Grid block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Video Grid”, insert it. Category: Media.
- Configure inspector controls that exist on this block. Open Videos. Set “Videos — Title”, “Video URL (YouTube/Vimeo)”, “Duration”, “Category”.
- Check the published page. The view script reads HTML data attributes: data-anim-delay, data-category, data-embed-url. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Videos — Title | Text field in the inspector. |
| Video URL (YouTube/Vimeo) | Text field in the inspector. |
| Duration | Text field in the inspector. |
| Category | Text field in the inspector. |
| Short description | Text field in the inspector. |
| Gap (px) | Numeric range control in the inspector. Range 8–48. block.json default: 24. Saved as `gap`. |
| Show category filter bar | On/off toggle in the inspector. On by default. Saved as `showFilter`. |
| Show category pill on card | On/off toggle in the inspector. On by default. Saved as `showCategory`. |
| Show duration badge | On/off toggle in the inspector. On by default. Saved as `showDuration`. |
| Show description | On/off toggle in the inspector. On by default. Saved as `showDescription`. |
| Card radius (px) | Numeric range control in the inspector. Range 0–24. block.json default: 14. Saved as `cardRadius`. |
| Thumb radius (px) | Numeric range control in the inspector. Range 0–24. block.json default: 10. Saved as `thumbRadius`. |
| Play button size (px) | Numeric range control in the inspector. Range 32–96. block.json default: 56. Saved as `playBtnSize`. |
| Padding top | Numeric range control in the inspector. Range 0–200. block.json default: 0. Saved as `paddingTop`. |
| Padding bottom | Numeric range control in the inspector. Range 0–200. block.json default: 0. Saved as `paddingBottom`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-anim-delay, data-category, data-embed-url.
- An IntersectionObserver starts work when the block enters the viewport.
- Keyboard handlers move focus between items.
When this is the right block
- Responsive grid of video cards with play-in-lightbox functionality. Supports YouTube, Vimeo, and self-hosted videos. Custom thumbnails, titles, and duration badges — that is the job of Video Grid, not a generic content block.
- Use it when you need the editor control labeled “Videos — Title”, which exists on this block’s inspector.
- It matches pages about video, grid, gallery.
- Inserter grouping: video, animation, and rich media sections.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Video Grid block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Video Grid”. It sits under Media. After insert, open Videos and set “Videos — Title”, “Video URL (YouTube/Vimeo)”, “Duration”, “Category”.
What makes Video Grid different from other Blockenberg blocks?
Responsive grid of video cards with play-in-lightbox functionality. Supports YouTube, Vimeo, and self-hosted videos. Custom thumbnails, titles, and duration badges. Inspector labels on this block include “Videos — Title”, “Video URL (YouTube/Vimeo)”, “Duration”, “Category”.
Is the Video Grid Gutenberg block free?
Yes. Video Grid ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Video Grid to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Videos, Layout, Display, Appearance).
Related media blocks
Video Popup Button
A stylizable play button that opens a YouTube, Vimeo, or custom video in a modern full-screen popup modal.
Background Video
A looping autoplay background video section with overlay and InnerBlocks content — distinct from video players or popups.
Image Gallery
Responsive image gallery with grid/masonry layouts, lightbox, and hover effects.
Lightbox Gallery
Image grid where clicking a thumbnail opens a full-screen lightbox with prev/next navigation.
Sticky Video
Video player that minimises into a floating corner player when scrolled past, with close and restore controls.
Video Facade
Performance-optimized video thumbnail that loads the actual YouTube or Vimeo player only on click. Eliminates heavy iframes on page load, improving Core Web Vitals. Supports custom thumbnails, overlay text, and animated play buttons.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Video Grid from the Gutenberg inserter.