Easy FancyBox

Wordpress Plugin
Download latest - 1.8.18



Download Stats

Today 4,460
Yesterday 5,989
Last Week 55,170
All Time 1,982,122
Banner 772x250

Easy FancyBox plugin for WordPress websites gives you a flexible and aesthetic light box solution for just about all media links on your website. Easy FancyBox uses an updated version of the traditional FancyBox jQuery extension and is WP 3+ Multi-Site compatible. After activation you can find a new section FancyBox on your Settings > Media admin page where you can manage the media light box options.

After activation, all links to JPG, GIF and PNG images are automatically opened in the FancyBox Mac/Gnome-style lightbox that floats over the web page.

GDPR / EU Privacy

This plugin does not collect any data and does not set any browser cookies. However, 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.


Supported media and content types:

  • All common image formats including webp
  • Hosted video on Youtube, Vimeo and Dailmotion
  • PDF files (embed with object tag, in iframe or in external Google Docs Viewer)
  • SWF (Flash) files
  • SVG media images (thanks to Simon Maillard)
  • Inline HTML content (see instructions in the FAQs)
  • External web pages (see instructions in the FAQs)

Also supports:

  • WordPress Galleries (option "Link to" must be set to "Media File")
  • NextGEN galleries (see instructions in the FAQs)
  • Image maps
  • WordPress menu items (see instructions in the FAQs)
  • Jetpack Infinite Scroll

Additional features:

  • Modal window option (see instructions in the FAQs)
  • Automatic detection of media file links
  • Automatic detection of galleries
  • Popup on page load optional (see instructions in the FAQs)
  • Fade or Elastic popup effects
  • Styling options for light box overlay (color and opacity) and window (border size and color)

For advanced options and priority support, there is a Pro extension available. See Pro features below.

See FAQ's for instructions to manage YouTube, Dailymotion and Vimeo movies (and similar services) and tips to make inline content display in a FancyBox overlay.

Get support on the Easy FancyBox web page or WordPress forum.

Visit FancyBox for more information and examples.


  • Priority support on dedicated forum
  • Slideshow effect for galleries (autorotation)
  • Spotlight effect for the light box overlay
  • FacetWP, Gravity Forms and TablePress compatibility
  • More styling options: rounded corners, inline content background and text colors
  • More automatic popup options: triggered by URL hash, first link by media type, hide popup after first visit
  • Pass dedicated light box setting per media link via link class (see Metadata instructions in the FAQs)
  • More elastic (easing) popup effects on open and close
  • Show/hide image title on mouse hover
  • Fine-tune media link and gallery autodetection to match your theme source markup to allow galleries per post for example

For these additional features, you need to install the Pro extension alongside this free plugin.


If you're happy with this plugin as it is, please consider writing a quick rating or helping other users out on the support forum.

If you wish to help build this plugin, you're very welcome to translate Easy FancyBox into your language or contribute bug reports, feature suggestions and/or code on Github.



  • Outbound click or Download tracking in some of the stats plugins can interfere with FancyBox. Disable such options or exclude links manually with a class if possible (see instructions for SlimStat below)
  • Most plugins and themes that already include a light box script. Continue reading to see if you are using one of the know ones or follow the troubleshooting steps to find out what is conflicting on your site.
  • Any theme that is missing the obligatory <?php wp_footer(); ?> call in the footer.php template.
  • When showing an iframe as inline content in FancyBox -- not advised, use fancybox-iframe instead! -- the iframe will become blank after opening and closing it. The solution is to link directly to the iframe source and use class="fancybox-iframe" instead.
  • Embedded flash content that has no wmode or wmode 'window', is displayed above the overlay and other javascript rendered content like dropdown menus. WordPress does NOT check for missing wmode in oEmbed generated embed code. Since version, the missing wmode is added by this plugin for WP (auto-)embeds but not for other user-embedded content. Please make sure you set the wmode parameter to 'opaque' (best performance) or 'transparent' (only when you need transparency) for your embedded content.

Plugin conflicts

  • jQuery Updater moves jQuery to version 2+ which is incompatible.
  • WP Slimstat and Matomo/Piwik with Track Outbound Clicks enabled, will break the light box effect on some browsers. Adding fancybox (or any of the other classes like fancybox-youtube,fancybox-iframe,fancybox-inline depending on which media should be displayed in FancyBox) to the Do Not Track field is reported to solve the issue. Slimstat also might interfere with the YouTube url conversion. When clicking a Youtube link, the movie opens in an overlay as it is supposed to but immediately after that, the complete page gets redirected to the original YouTube page. Adding a class="noslimstat" to the link is reported to work around the issue.
  • Google Analytics for WordPress converts links like href="#anyID" to href="http://yoursite.url/page/#anyID", disabling inline content shown in FancyBox.
  • Both the uBillBoard and Camera slideshow have their own easing script hard-coded which conflicts with the one in Easy FancyBox. The only way around the conflict is to set both the Easing In and Easing Out options on your Settings > Media page to Swing.
  • Wordpress Firewall 2 blocks access to image files needed for proper display of the FancyBox overlay in older IE and other non-css3 browsers.
  • WordPress Amazon Associate: A script provided by Amazon and the FancyBox script are incompatible. Disabling Product Preview in the WP - Amazon > Settings page should work around the issue.
  • WP Supersized uses the Animate Enhanced jQuery extension which causes a conflict with the Easing extension used by FancyBox resulting in a 0px sized lightbox frame and/or some kind of positioning issue with auto-centering.

Theme conflicts

  • Older versions of Elegant Themes have FancyBox integrated in a hard-coded way, making them incompatible with Easy FancyBox. In the latest versions of these themes, there is an option to disable the included FancyBox. Use this option to make your theme compatible with Easy FancyBox :)
  • The Mystique theme has two options called "Lightbox" and "Optimize website for faster loading" that will break Easy FancyBox. Disable both in Mystique's options > Advanced.
  • Imbalance and other themes that uses the Photo Galleria jQuery extension: turn of the JSGallery option.
  • Themes like Envisioned, Chameleon and many others have FancyBox baked in. There is no solution other than stripping the theme of all FancyBox related code or better: disable the plugin and use the theme provided version...
  • Themes based on the Thesis framework might see issues in IE 8, for which a hack has been proposed

Releases (39 )

Version Release Date Change Log
1.8.18 2019-09-20

Fix Jetpack Tiled Gallery compat + security issue reported by Jakob Hagl sba-research.org


1.8.17 2019-08-12

Fix compat messages and links


1.8.16 2019-05-08
  • FIX: Trying to get property 'ID' of non-object
  • mark WordPress 5.2 compatible
1.8.15 2019-05-05
  • FIX: inline wrapper nesting issue
  • Revert to file names without version
1.8.14 2019-04-06

Fix inline wrapper nesting issue, versionless file names


1.8.13 2019-01-22

Prepare Visual Composer Masonry Grid Gallery compatibility option


1.8.12 2019-01-19

Prepare Visual Composer Masonry Grid Gallery compatibility option


1.8.11 2018-12-29

Force default autoselector for galleries


1.8.10 2018-12-28
  • Force default autoselector for galleries
1.8.9 2018-10-25

Prevent gallery next/prev links to show dud target.


1.8.8 2018-09-20

Improved Youtube regex.


1.8.7 2018-09-02

Autoplay for Youtube, Vimeo and Dailymotion. Bugfixes.


1.8.6 2018-08-01

Gutenberg compatibility and other bugfixes.


1.8.5 2018-08-01

Bugfix release: prevent Inline content title.


1.8.2 2018-05-05

Bugfix release: video autoplay and https; default enqueue priority; possible max stack reached by image preloader.


1.8 2018-04-26

Many FancyBox improvements. New options: Google Docs Viewer for PDF, Youtube privacy-enhanced embed, theme and plugins compatibility options. Pre WP 4.5 compatibility.


1.7 2018-04-14

Fix: pre PHP5.4 compatibility. Switch to wp_add_inline_script() script printing.


1.6.3 2018-03-16

Switch to wp_add_inline_script() and fix inline js minification incompatibility


1.6.2 2018-03-16
  • FIX: line breaks hidden on options media admin page since WP4.9, thanks @garrett-eclipse
1.6.1 2017-11-26
  • 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
1.6 2017-11-24
  • 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 2017-05-11

= 1.6 = Webp images autodetected by default. Some common rel tags excluded from autogallery. FIX: image preload. 2016-11-26

= = New features: auto-popup delay, margin, nolightbox... Bugfixes and PHP7 compatibility

1.5.8 2016-11-25
  • FIX: variable variable php 7 compat
  • Dropped IE6 support
  • 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
1.5.7 2016-11-24
  • 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 2015-02-06

Metadata and image map support. Opening speed bugfix. New iFrame/HTML5 embed code for Youtube, Vimeo and Dailymotion. Frame color and opacity options. Media options simplification.


1.5.6 2014-07-17

Bugfix release.


1.5.5 2013-12-13

Mousewheel fix. New approach for IE alphaimageloader path fix with less compatibility issues.


1.5.2 2013-08-21
  • BUGFIX: easy_fancybox_handler() in combo with trigger('click') causes Uncaught Exception script error
1.5.0 2013-06-25

Many new options. Speed improvements: stylesheet browser caching, metadata.js compression. Security fix. Dutch, Indonesian and Polish translations.

= 2011-06-10

PDF bugfix. Improved auto-enable and auto-gallery settings and a Spotlight effect!

= 2011-02-20

PDF compatibility improvement, Dailymotion support and many new options and classes.

= 2011-01-24

FancyBox version 1.3.4 plus added PDF support and LOTS more options like border, overlay color, Easing, Title and adjustable YouTube, Vimeo and iFrame sizes! Missing WordPress auto-embed wmode fix.

= 2010-11-09

Size issue with fancybox-swf and iframe classes. Quick fix for image overlay size in Google Chrome browser issue with FancyBox 1.3.3

= 2010-11-05

New FancyBox version 1.3.3 included. Vimeo support. Auto-recognition of YouTube and Vimeo links.


1.3.2 2010-10-29
  • upgraded FancyBox script to version 1.3.2 2010-10-27
  • translation .pot file available
  • Dutch translation
  • Youtube and Flash movie support
  • Iframe support
  • added option Auto-enable for... 2010-09-08
  • added option titlePosition : over / inside / outside
  • added option transitionIn : elastic / fade / none
  • added option transitionOut : elastic / fade / none
1.3.1 2010-09-06
  • Using FancyBox version 1.3.1