WordPress lightbox popup showing an enlarged image with navigation arrows and play button
- WordPress Tutorials

How to Add a Lightbox to WordPress (Images & Video)

A lightbox is the popup that appears when you click a thumbnail image or video — the rest of the page dims, and the full-size content shows in an overlay without navigating away. It’s one of the simplest ways to make a gallery, portfolio, or product page feel more polished, but a lot of WordPress themes don’t include one by default, and not every plugin that claims lightbox support actually handles video well.

This guide covers both: adding a lightbox for images, and specifically for video — which is a separate, often trickier problem.

Video lightbox with YouTube embed in WordPress

Why a lightbox matters for images

Without one, clicking a thumbnail either does nothing, or opens the full image as its own page — pulling the visitor away from whatever they were browsing. A lightbox keeps them in context: they see the full-size version, close it, and pick up exactly where they left off. This matters most on portfolio pages, product galleries, and photo-heavy blog posts.

Why video lightboxes are a different problem

A lot of plugins that handle image lightboxes well fall apart on video — either the video doesn’t autoplay correctly inside the popup, YouTube/Vimeo embeds break the layout, or the popup doesn’t properly stop playback when closed (leaving audio running in the background, which is a bad experience). If your primary need is video, look specifically for lightbox support that mentions YouTube/Vimeo handling, not just generic “works with video” claims.

What to look for in a WordPress lightbox plugin

  1. Native Gutenberg block support — so you’re not stuck with shortcodes or fighting page-builder conflicts
  2. Proper video handling — autoplay inside the popup, and playback stops when closed
  3. Touch/swipe support if the lightbox includes multiple images (a gallery lightbox, not just a single-image popup)
  4. Lazy loading — a lightbox gallery with dozens of images shouldn’t load them all upfront and slow down the page
  5. Caption support — being able to show a title or description under the enlarged image

A few options to consider

Ultimate Lightbox : Lightbox plugin that lets you add a lightbox to any or every image on your site simply by clicking on a checkbox on the plugin’s options page.

Lightbox with PhotoSwipe : This plugin integrates PhotoSwipe to WordPress. All linked images in a post or page will be displayed using PhotoSwipe, regardless if they are part of a gallery or single images.

For image galleries: Continuous Image Carousel With Lightbox is a free, continuously-scrolling thumbnail slider with a responsive lightbox built in — click any thumbnail and it opens in a popup with captions and optional links, no separate lightbox plugin needed. The Pro version adds unlimited sliders and bulk image upload for larger galleries.

Image lightbox popup example in WordPress

For video specifically: WordPress Responsive Video Grid Pro is built around exactly the video-lightbox problem described above — it supports YouTube, Vimeo, Metacafe, Dailymotion, and self-hosted HTML5 video, all opening in a responsive lightbox with the video description shown alongside. Thumbnails and titles are fetched automatically from the video URL, so there’s no manual thumbnail work for large galleries.

How to add a lightbox to WordPress

  1. Install a lightbox-capable plugin from Plugins → Add New
  2. Look for its block in the Gutenberg block inserter, or use the shortcode/widget it provides
  3. Upload your images or add video URLs (YouTube/Vimeo links, typically)
  4. Preview the popup — click a thumbnail and confirm it opens smoothly, closes cleanly, and (for video) actually stops playing when you close it

Testing checklist before you publish

  • Click through on mobile, not just desktop — some lightboxes don’t handle touch well
  • If using video, confirm the popup doesn’t cause layout shift on the page (a common Core Web Vitals issue with poorly-built lightbox plugins)
  • Check that closing the lightbox actually stops any playing video/audio

About Nikunj Gandhi

Read All Posts By Nikunj Gandhi