Add a YouTube and Vimeo video gallery to WordPress in minutes

The setup most sites settle for

Paste a YouTube link into the WordPress editor and you get a full embed. Paste 12 of them onto a page and your browser loads 12 iframes, each pulling roughly one megabyte of JavaScript before the page is interactive. Your Lighthouse score collapses. Your visitors close the tab. This is the default WordPress video gallery experience, and it is the reason people think video galleries on WordPress are fundamentally broken.

They are not. They just need a grid plugin that understands videos as first-class content, lazy-loads the thumbnails, and opens the actual video in a lightbox only when someone clicks it.

What a good video gallery actually needs

• Lazy-loaded thumbnails. The page should not wait for YouTube to boot a dozen iframes.
• Click-to-play lightbox. The video loads when the visitor asks for it, not on first paint.
• Responsive grid. Three columns on desktop, two on tablet, one on mobile, with the thumbnail aspect ratio preserved.
• Mixed source support. YouTube, Vimeo and Wistia in the same gallery. Most brands post to more than one platform.
• Filters or tags. A tag bar so visitors can narrow the gallery by topic without reloading the page.
• No local video files. The video providers deliver faster than any WordPress host ever will.

The five-minute setup with Grid FX

1. Install Grid FX

Upload the zip through Plugins then Add New, activate it, and the Grid FX menu appears in wp-admin. The plugin handles image, video and mixed-media grids, so you will not need a second plugin if you add photo galleries later.

2. Add your videos

Create a new grid, choose the video source type, and paste YouTube or Vimeo URLs one per line. Grid FX fetches the thumbnail, title and duration from each provider automatically. A hundred videos cost roughly nothing in disk space because the video itself stays with YouTube or Vimeo.

3. Pick a skin and column count

Grid FX ships around 20 built-in skins. For a video gallery the two that matter are the masonry skin (if your thumbnails are different aspect ratios) and the uniform grid (everything 16:9). Pick a column count for desktop, tablet and mobile. Save.

4. Drop the shortcode into a page

Grid FX shows a shortcode at the bottom of the grid settings. Edit the page you want the gallery on, insert a shortcode block, paste the shortcode, publish. No page builder, no extra lightbox plugin, no separate lazy-load plugin. The gallery lazy-loads thumbnails, opens videos in a lightbox on click, and collapses responsively on tablet and mobile.

Tags and filters

Grid FX uses a simple tag field per video. Tag your videos with things like tutorial, product demo, or customer story, turn on the filter bar in the skin settings, and visitors can narrow the gallery without reloading the page. The skins page shows each skin with the filter bar enabled.

Performance notes that matter

• Grid FX serves thumbnails using the browser’s native lazy-load attribute. A 50-video gallery first-paint is a dozen tiny images plus the grid CSS.
• The YouTube iframe loads only after a click, so the initial page load is identical whether you have 10 or 100 videos in the grid.
• If you run a cache plugin (WP Rocket, LiteSpeed, Breeze), no exclusions are needed. Grid FX’s HTML caches cleanly.
• For Core Web Vitals, the gallery scores roughly the same as a page with the same number of static images. Compare that to a page of raw YouTube embeds, which rarely clears LCP under 4 seconds.

Google has a short reference on native lazy-loading if you want the background on what the browser is actually doing.

What not to do

• Do not paste 50 raw YouTube embeds onto a single page. You will load 50 iframes on first paint, each about one megabyte of JavaScript.
• Do not host the video files on your WordPress uploads directory. Your host will hate you, your LCP will tank, and YouTube delivers the same video faster to the visitor anyway.
• Do not put a custom React player in front of the lightbox. Native YouTube and Vimeo embeds handle captions, accessibility and keyboard controls out of the box. A custom wrapper almost always regresses one of those three.
• Do not rely on autoplay. Browsers block it on mobile without a user gesture, and visitors find it annoying on desktop. Autoplay with sound is dead. Autoplay without sound rarely adds anything.

Where to next

If you want to see every skin before you buy, the skins page has a live demo of each. The docs section covers shortcode options and the REST hooks if you need to populate grids programmatically. For help picking between the masonry and uniform layouts, the FAQ answers the pre-sale questions we get most often.

Frequently asked questions

Does Grid FX work with the block editor?

Yes. Drop a shortcode block and paste the Grid FX shortcode. No custom block is required, so the same shortcode works in classic, block and hybrid editors identically.

Can I mix image and video tiles in one gallery?

Yes. Grid FX supports mixed-media grids, so a single gallery can combine local image uploads with YouTube or Vimeo URLs. The lightbox handles both, and the tag filter bar works across content types.

Will the videos autoplay?

By default, no. Videos open in the lightbox and play when the visitor clicks play. Autoplay is available in the skin settings, but browsers block autoplay with sound on mobile, and most visitors find autoplay annoying anyway.

Can I pull videos dynamically from a YouTube playlist?

Yes. Grid FX can import a YouTube playlist or channel URL and refresh it on a schedule. Vimeo showcase URLs work the same way. New uploads appear in the gallery without you touching the site.

Does it slow down my WordPress site?

Not noticeably. Thumbnails lazy-load, video iframes load only on click, and the gallery HTML caches cleanly on any major WordPress cache plugin. Lighthouse scores stay roughly the same as a page of static images.

Is there a way to self-host the videos instead?

You can, but we do not recommend it. YouTube and Vimeo handle encoding, adaptive bitrate, captions and CDN delivery for free. Your WordPress host charges for bandwidth and does none of that automatically. Stick with an embed-based approach unless there is a regulatory reason not to.