Easy FancyBox – WordPress Lightbox Plugin


Easy FancyBox is the most popular lighbox plugin for WordPress, active on over 200,000 WordPress installations. It adds a lightweight and flexible lightbox for viewing images, video, and other media on your website.

After activation, links to images, galleries, videos, pdfs, maps, modals, etc, will open in a lightbox. Settings will be under ‘Lightbox’ on your main admin menu.


Demos for images, videos, PDFs, maps, and modals/popups:

Free Lightbox Demo
Pro Lightbox Demo – Light Theme
Pro Lightbox Demo – Dark Theme

– Automatic detection of images
– Automatic detection of galleries
– Customize options for Lightbox appearance, style, and behavior
– Opens all common image formats including webp and svg
– Opens WordPress core galleries
– Opens videos from Youtube, Vimeo, and Dailmotion
– Opens PDF files (embed with object tag, iframe, external Google Docs Viewer)
– Opens NextGEN galleries (instructions)
– Opens content from external web pages (instructions)
– Create easy modals and popup boxes (instructions)
– Open image maps (instructions)
– Open lightbox from WordPress menu items (instructions)
– Support for Jetpack Infinite Scroll
– Support for WordPress Multsite (see Installation instructions)

-> Demos
-> Docs
-> Free Support


Easy Fancybox Pro is an extension for this lightbox plugin that offers:
– Priority support via email directly from devs
– Pro features for free lightboxes (Fancybox Legacy, Classic, V2)
Powerful Pro Lighbox based on Fancybox 5
– Beautiful, modern full-browser and full-screen ligthbox
– Dozens of customizations options
– Thumbnails within the lightbox
– Toolbar with controls for thumbs, zoom, slideshow, and more
– Support for videos, pdfs, modals/popups, inline content, iframes, maps, and more
– Flawless mobile interaction
– Hyper fast performance


GDPR / EU Privacy

This plugin does not collect any data or set any browser cookies. The PRO version offers an option to disable the automatic popup after the first visit, which needs a browser cookie. This cookie stores the visitors first website visit timestamp and path on the client side. It is not shared nor is any data stored server side or elsewhere.


If you’re happy with this plugin, please consider writing a quick rating, helping others in the forum, or translating.

Known conflicts & issues

See Easy FancyBox Troubleshooting.


  • Example image with Overlay caption. This is the default way Easy FancyBox displays images. Other options are Inside and the old Outside.

  • Example of a YouTube movie in overlay.


Install like any other plugin. Search for ‘lightbox’ or ‘easy fancybox’ from your WordPress admin plugin page. Or download the zip from this page, and upload the zip via your admin plugins page.

WordPress Multiste

The plugin is compatible with multisite. You can enable the plugin network wide, or allow individual sites to activate it.

When activating the plugin per site, each site will have the Images media type activated and Easy FancyBox will immediately try opening image links in the light box.

When activated network wide with Network Activate, each sub-site will not have any media type activated. The options will be there for individual site admins, ready to either activate or leave deactivated.


جُلائی 12, 2024 2 replies
The site I manage for an art gallery depends heavily on features of this plugin I have found nowhere else. The gallery hosts one or two monthly shows IRL. I use images of the art to create online shows. The online pages consist of a set of separate <img/> elements. The excellence of this plugin comes from two features. I can group those images into a single lightbox using the rel attribute to manually group the images together. Each image in the lightbox gets a caption constructed dynamically from custom metadata and stored in the alt image attribute, thanks to the option to allow getting the lightbox title from the thumbnail alt attribute. Note that the thumbnails are not all scrunched together the way they are in most gallery plugins. I have total control over the thumbnail layout and at the same time, the plugin gathers all the images together in a single group. This is most excellent. Unfortunately, the two features of the plugin I most rely on are not available in the “Pro” version, which has become just like every other gallery plugin, a tight cluster of unlabeled images. As much as I like the advanced features of the Pro lightbox, the developers have made it impossible for me to take advantage of them.
جُلائی 11, 2024
I was having trouble with another popular lightbox plugin. No matter what I did, the linked images were going to the image file and not generating a lightbox view. The site I was working on is pretty image-intensive, so I didn’t want to go in and re-code all the tags and links. And I didn’t need a lot of options or features. When I installed and activated this plugin everything just worked.
Read all 205 reviews

Contributors & Developers

“Easy FancyBox – WordPress Lightbox Plugin” is open source software. The following people have contributed to this plugin.


“Easy FancyBox – WordPress Lightbox Plugin” has been translated into 14 locales. Thank you to the translators for their contributions.

Translate “Easy FancyBox – WordPress Lightbox Plugin” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Update: Settings screen title
  • Update: Refactor/fix how gallery grouping works
  • Update: Email opt in for all users
  • Fix: Save message on settings screen
  • Fix: Vimeo player links for Fancybox2


  • Skipped


  • New: Modal for email opt ins
  • Update: Apply code standards to some files
  • Fix: “Automattically group images” setting issue


  • New: Options to hide/close lightbox panel in block editor
  • Update: Apply coding standards to fancybox-options.php
  • Fix: wp_enqueue_script syntax error


  • Fix: Adopt older wp_enqueue_script syntax


  • Updated: Apply code standards to admin class
  • Udpated: Raise compatible version of pro to 2.0.0


  • Added: JavaScript build set up with wp-scripts
  • Added: Lightbox panel in block editor
  • Updated: Coding standard for main plugin file
  • Updated: Coding standards for easyFancyBox class


  • Updated: PHP coding standards to all view files
  • Updated: Refine admin JS enqueuing
  • Updated: Minor markup changes to admin pages


  • Added: Pro landing page for re-launch of Pro
  • Added: Optoin to disable core lightbox
  • Updated: Refined styling / JS for options screen
  • Updated: Default video width and height values
  • Fixed: JS console error on admin dashboard
  • Fixed: Lightbox buttons not working on mobile


  • Added: Fancybox V2 option for retina displays


  • Update: Check WordPress version before using some functions


  • Update: Automattically open image blocks without links
  • Update: Automattically open gallery blocks without links
  • Update: Disable core lightbox when active
  • Update: WordPress tested version to 6.5.3


  • Update: Allow % width/height for PDFs
  • Update: Increase review requests to 50% of users


  • Update: Adjust review request, up to 20% of users
  • Update: Update plugin banner and icon


  • Update: Review request on dashboard, 10% of users


  • Update: Review requests to 40% of users


  • Added: Request plugin reviews (10% of users)


  • Added: Fancybox2 transitions


  • Fixed: Iframe width/height


  • Fixed: Issues on new setting page


  • Remove overlay background check


  • Fixed overlay background settings


  • Fixed some PHP errors


  • Added new options screen
  • Consolidate options for lightboxes
  • Use Settings API for saving
  • Remove unused files


  • Added .jpeg to autodetect extensions
  • Added plugin activation timestamp


  • Removed unused scripts and files
  • Updated WordPress required version to 5.0


  • First small release by FirelightWP
  • Updated author, readme, plugin meta

=1.9.6 =
* Updated author
* Updated links to new site

=1.9.5 =
* FIX: ARIA attributes
* FIX: jQuery.fn.click() shorthand deprecated


  • FIX: Classic large content scroll
  • FIX: Classic gallery overflow flicker
  • FIX: Legacy float title position
  • FIX: upgrade notice
  • FIX: overlay opacity ignored (classic)
  • FIX: onStart not a function (legacy)
  • FIX: Passing event parameters failing
  • FIX: Case insesitive selectors failing
  • FIX: Admin message display issue


  • NEW: Swipe support
  • NEW: Optional fancyBox 2 or Legacy scripts
  • Fixed background
  • Dropped IE6-8 support
  • Dropped SWF support (only availbale in Legacy)
  • Accessibility improvements


  • Admin settings links
  • Pro compatibility message for VideoPress
  • NEW: Exclude selector option
  • FIX: border 0 ignored sometimes


  • FIX: Jetpack Tiled Gallery block compatibility
  • Don’t include mousewheel script by default
  • SECURITY: fixed failing color value sanitization + added inline styles output filter, issue reported by Jakob Hagl sba-research.org


  • Pro compatibility messages
  • Support forum link


  • FIX: Trying to get property ‘ID’ of non-object
  • mark WordPress 5.2 compatible


  • FIX: inline wrapper nesting issue
  • Revert to file names without version


  • FIX: version constant issue
  • Prepare Visual Composer Masonry Grid Gallery compatibility option


  • FIX: Vimeo player direct links breaking


  • Force default autoselector for galleries


  • Prevent gallery next/prev links to show dud target
  • FIX: allow youtube url parameters before v=


  • Autoplay Youtube/Vimeo/Dailymotion
  • FIX: Exclude Vimeo user pages from autodetect
  • FIX: Exclude facebook/twitter share link
  • FIX: PDF embed tag


  • Gutenberg file block download button compatibility
  • Gutenberg gallery block compatibility
  • FIX: Missing argument in easyFancyBox::add_video_wmode_opaque()
  • Remove version URL parameters
  • FIX: jQuery 3+ e.indexOf is not a function


  • FIX: prevent Inline content title


  • Improved center on scroll behavior with title outside
  • FIX: Pro options compatibility


  • FIX: AutoScale option restored
  • FIX: outline issue in Firefox
  • Prevent SiteGround Optimizer warning about break outside loop


  • FIX: main method not returning true in some cases
  • Force all hosted video to https
  • FIX: video iframe needs allow=”autoplay” on modern browsers
  • FIX: default enqueue priority not 10
  • FIX: possible infinite loop in prev/next and image preloader
  • Move main method (back) to init, position 9
  • Introducing easy_fancybox_enqueue_scripts action hook


  • NEW: Google Docs Viewer for PDF
  • NEW: Youtube privacy-enhanced embed
  • NEW: Compatibility options: late script inclusion, jquery exclusion, no wp_add_inline_script
  • FancyBox: Improved mobile viewport height detection
  • FancyBox: now skips subsequent double links in gallery
  • FancyBox: new PDF content type
  • FancyBox: improved error messages
  • Dedicated IE8 stylesheet
  • jQuery Easing update to 1.4.1


  • NEW: Aspect ratio for video frames on smaller screens
  • NEW: Global minimum screen size
  • NEW: Loading icon for video/iframe content
  • NEW: Resize light box on device orientation or browser window size change
  • NEW: Modal window class and close button class
  • FIX: pre PHP 5.4 compatibility
  • FIX: iPhone iframe scrolling
  • FIX: Autoptimize compatibility
  • Switch to wp_add_inline_script() script printing, thanks @szepeviktor


  • FIX: inline js minification incompatibility, thanks @alexiswilke


  • FIX: line breaks hidden on options media admin page since WP 4.9, thanks @garrett-eclipse


  • Nolightbox class in menu also for other media types than images
  • FIX: CSS color code
  • Spelling fixes, thanks @garrett-eclipse
  • FIX: Pinterest button compatibility
  • FIX: Double load plugin text domain


  • Add webp to default Autodetect image types
  • Exclude more rel attribute values from galleries
  • BUGFIX: gallery preload
  • Update jquery.easing.js and jquery.mousewheel.js

  • BUGFIX: use dirname(FILE) instead of relying on DIR to be available
  • Explicit transparency for gallery navigation links


  • FIX: variable variable php 7 compat
  • FIX: obj undefined in minified js
  • FIX: nofancybox in menu ignored, thanks Trishah
  • Color value sanitize
  • NEW: auto popup delay
  • NEW: pro extension version compatibility check routine
  • NEW: margin option
  • NEW: iFrame alow full screen option
  • Dropped mu-plugins support
  • Added support for universal nolightbox class
  • Set focus on iframe after load
  • FIX: No center on scroll on touch devices
  • FIX: Allow fullscreen videos


  • FIX: Pro extension link update
  • NEW: WebP support and class=’image’ to force image media type
  • IE 6-8 css rules optional
  • iframe embed for Youtube, Vimeo and Dailymotion
  • Croation translation
  • HTML5 players allowfullscreen default


  • iPad positioning patch
  • Don’t unregister scripts that are not ours even for conflict prevention
  • box-sizing: border-box issue in Firefox fixed
  • Allow mousewheel scrolling page in the background again


  • Prevent mousewheel scrolling page in the background
  • New stylesheet IE alphaimageloader path fix approach
  • Czech translation added
  • Updated Indonesian translation


  • BUGFIX: easy_fancybox_handler() in combo with trigger(‘click’) causes Uncaught Exception script error


  • FIX: jQuery 1.9+ compatibility
  • Dropping support for gForms again — “Cannot convert ‘c’ to object” error in combination with some older gForms version 🙁
  • NEW: support for Infinite Scroll by Jetpack


  • FIX: CSS3 box-sizing issue (Twenty Thirteen) misplacing close button
  • NEW: Added SVG support. Thanks to Simon Maillard.
  • Pre WP 3.6: jQuery 1.9+ compatibility
  • JQuery Mousewheel extension update to 3.1.3
  • NEW: Elegant Themes compatibility
  • Some small Touch device compatibility improvement hacks to the 1.3.4 script
  • Major plugin overhaul: Class implementation
  • NEW: Disable hide on overlay click
  • NEW: Allow automatic resizing to large image size set on Settings > Media during media upload via the hidden WordPress function media_upload_max_image_resize()
  • NEW Options: iFrame scrolling, autoScale, key navigation/close, cyclic galleries
  • Metadata custom parameters and Mousewheel gallery scrolling scripts optional
  • Basic RTL languages/text direction support (gallery navigation inversion, title position)
  • BUGFIX: https in stylesheet on Windows IIS
  • Improved W3TC compatibility: query string issue
  • Gravity Forms in ajax mode compatibility
  • Use jQuery’s bind(‘ready’) for better ajax content compatibility
  • Dynamic stylesheet response headers to allow browser caching
  • Minified version of jquery.metadata.js
  • Auto-detect on image map areas
  • nolightbox class for menu items
  • SECURITY: Settings sanitization
  • BUGFIX: load_textdomain firing after the main settings array is loaded, leaving text strings in it untranslated.
  • BUGFIX: missing signs in Youtube url regular expression
  • BUGFIX: unquoted rel attribute selectors in jquery.fancybox-1.3.4.js
  • BUGFIX: broken url path in IE stylesheet when missing $_SERVER[‘SERVER_NAME’]
  • BUGFIX: easing extension not needed on linear easing

  • NEW: Lithuanian translation
  • NEW: Hindi translation
  • NEW: Indonesian translation
  • NEW: Romanian translation
  • NEW: Polish translation
  • NEW: Spanish translation
  • NEW: jQuery Metadata support
  • NEW: Image map AREA support for all content types
  • NEW: new iFrame/HTML5 embed code for YouTube, Vimeo and Dailymotion
  • NEW: fix WordPress Dailymotion auto-embed code missing wmode
  • Some changes to default settings
  • Updated Dutch translation
  • BUGFIX: Opening speed

  • NEW: Advanced option: Gallery auto-rotation
  • NEW: Spotlight effect
  • Improved auto-enable and auto-gallery settings
  • BIGFIX: CSS IE6 hack
  • BIGFIX: PDF object in IE7

  • PDF embed compatibility improvement
  • NEW: Show/hide title on mouse hover action
  • NEW: Auto-gallery modes (Disabled, page/post images only, all)
  • NEW: Dailymotion support
  • Links with id fancybox-auto will be triggered on page load
  • Anything with class fancybox-hidden” will be hidden
  • Support for menu items in iframe
  • Added class nofancybox for exclusion when auto-enabling

  • FancyBox script version 1.3.4 (2010/11/11 – http://fancybox.net/changelog/)
  • NEW: Support for PDF
  • NEW: Easing options
  • YouTube, Vimeo and iFrame options adjustable
  • lots and lots of more options!
  • BIGFIX: work-around for missing wmode in WordPress (auto-)embedded movies (credits: Crantea Mihaita)

  • BIGFIX: iframe width
  • BIGFIX: image overlay size in Google Chrome browser issue (FancyBox 1.3.3)
  • BIGFIX: fancybox-swf

  • FancyBox script version 1.3.3 (2010/11/4 – http://fancybox.net/changelog/)
  • Vimeo support
  • YouTube Short URL support (disabled by default)
  • Auto-recognition and seperate class fancybox-youtube for YouTube
  • Auto-recognition and seperate class fancybox-vimeo for Vimeo


  • FancyBox script version 1.3.2 (2010/10/10 – http://fancybox.net/changelog/)

  • translation .pot file available
  • Dutch translation
  • NEW: YouTube and Flash movie support
  • NEW: Iframe support
  • added option Auto-enable for…

  • added option titlePosition : over / inside / outside
  • added option transitionIn : elastic / fade / none
  • added option transitionOut : elastic / fade / none

  • small jQuery speed improvement by chaining object calls


  • Using FancyBox version 1.3.1