This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Easy SwipeBox


Easy SwipeBox plugin for WordPress websites gives you a flexible, aesthetic and mobile-friendly Lightbox solution for just about all media links on your website. Easy SwipeBox uses the packed SwipeBox and is multisite compatible.

Main features

  1. Enqueuing of SwipeBox Javascript and CSS files.
  2. Customization of SwipeBox lightbox appereance and behaviour from the Lightbox Settings page.
  3. Autodetection of links to images or videos. You can exclude/include media types from the Autodetection Settings page.
  4. Other geek settings in the Advanced Settings page.


Select one or more options from Autodetection setting page, Easy SwipeBox automatically detects the media type and add class="swipebox" to their links.
Otherwise, add class="swipebox" yourself to make the magic happen.

If you like to exclude some images or videos from autodetection enter the selector that groups these elements.
By default, Easy SwipeBox uses .no-swipebox.


There are many ways to contribute to this plugin:

  1. Report a bug, submit pull request or new feature proposal: visit the Github repo.
  2. Translate it in your language: visit the WordPress translation page.
  3. Rate it 5 stars on
  4. Buy me a beer!


Need help? Read the FAQ or visit the support page / Github Issue Tracker.

Note: this plugin use SwipeBox jQuery plugin as Lightbox solution. For any issues and pull requests related to SwipeBox functionalities please visit the SwipeBox Repo.


  • Example of SwipeBox lightbox

  • Easy SwipeBox setting page


  1. Download the plugin from WordPress repository.
  2. Upload the plugin folder in /plugins/.
  3. Activate the plugin.

Done! Now all link to image or Youtube/Vimeo opens in a beautiful mobile-friendly Lightbox.
Visit the new admin page (Settings > Easy SwipeBox) to enable/disable the autodetection for selected media type and customize the lightbox behaviour.


Can I use Easy SwipeBox to show Google Maps iframe?

Yes, SwipeBox support inline content, here below an example of code:

First create the selector that contains the Google Maps iframe, usually it’s hidden within the page:


Then create your link, pointing at the selector:
Click to open the map

Done! Clicking on the link, the Google Maps iframe will be showed within the lightbox.


24 Փետրվարի, 2021
Thanks for submitting the plugin. Saved me the time of having to enqueue Swipebox into my theme.
25 Մարտի, 2019
Swipebox is a great mobile-first image viewer. This plugin Just Works™, and it has an excellent admin panel exposing all the Swipebox settings. If I had one feature requests, it’s that I’d like photos to be grouped by post, instead of putting every image on the page into the same group. If you are currently using my old WP-jQuery Lightbox, strongly consider replacing it with Easy SwipeBox. It is better maintained, and provide a better experience on mobile devices. Thanks Leonardo for putting this together!
6 Սեպտեմբերի, 2018
This integration of the famous Swipebox image lightbox is really sweet, lightweitch and efficient. Works out of the box, mobile friendly and so smooth. Thank you for your awesome job !
23 Օգոստոսի, 2018
So simple and elegant, yet easy to customise. Works great as a «carousel-lightbox» for all the images in a posts since it goes through them all. Great touch capability and is neat. Suggestions for further development: Click outside image should close box on desktop, at least available. Show image thumbnails in bottom as a carousel, choosable ofc. Add this code to fix the close button position on desktop vs touch media if your page has a vertical scrollbar. The close button is a sprite image and is placed to narrow to the edge on desktop if you got a scrollbar. #swipebox-close { background-position: 5px 12px; } @media screen { #swipebox-close { background-position: 15px 12px; } }
Read all 16 reviews

Contributors & Developers

“Easy SwipeBox” is open source software. The following people have contributed to this plugin.


Translate “Easy SwipeBox” into your language.

Interested in development?

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


1.1.2 — Major release (26/02/2021)

1.1.1 — Major release (09/12/2020)

1.1.0 — Major release (27/01/2016)

  • New feature: Added Lightbox Setting Page. Customize the SwipeBox lightbox behaviour. Discover more about SwipeBox options.
  • New feature: Esclude media from autodetection. Exclude some images or videos from autodetection entering the selector that groups these elements.
  • New feature: Advanced settings Page. Customize geek options, like javascript files position (header/footer) and choose to enqueue minified or unminified version of the files.
  • New feature: Overview page.
  • Security issue: Fix SwipeBox XSS vulnerability (see SwipeBox pull request).
  • Updated readme.txt.
  • Updated licence.

1.0.2 (22/11/2015)

  • Bug fix: moved from wp_print_scripts to wp_enqueue_scripts. Better compatibiliy with Soil plugin from Roots. Thanks to Gifford Nowland

1.0.1 (28/10/2015)

  • Bug fix: better image format detection (jpg -> .jpg). Thanks to jas8522
  • Updated readme.txt

1.0 — Major release (14/09/2015)

  • Updated SwipeBox to 1.4.1
  • Bug fix: Added support to UPPERCASE image extension
  • Bug fix: Removed SwipeBox to Youtube User and Channel links
  • New feature: Added admin page for autodetection settings.

0.9.1 (14/04/2015)

  • Bug fix: Added JPEG extension support
  • Bug fix: Use image title as link title (alt fallback)

0.9 (02/02/2015)

  • First commit