jQuery plugin that converts your list of images into a grid-based gallery on Bootstrap 4. Supports larger view in a modal with next / previous controls
JavaScript HTML CSS
Switch branches/tags
Nothing to show
Clone or download
Latest commit 88a3676 Jan 30, 2018



A jQuery plugin that will automatically create a Photo Gallery based on an unordered list of images. Supports image captions, modal, with "next" and "previous" paging. Plugin requires Bootstrap and jQuery.

Current version Bootstrap 4

If you want an older version of the plugin (uses Bootstrap 3), download this branch

View Demo

alt tag

How to Use:

Make sure you include the required files before the plugin.

You need to create an unordered list of your images.

       <img alt="Night away"  src="images/photodune-174908-rocking-the-night-away-xs.jpg">
       <p>Optional text. This will also show in the modal</p>
       <img alt="Yellow boy" src="images/photodune-287182-blah-blah-blah-yellow-road-sign-xs.jpg">
       <img "Some colors"  src="images/photodune-460760-colors-xs.jpg">

Then initialize the plugin.


You can pass the different options such as BS classes for different sizes

opts = {
   "classes" : "col-lg-2 col-md-4 col-sm-3 col-xs-12",
    "hasModal" : false

The following options are available:

Option Type Description Default Value
classes string Bootstrap Grid classes col-xl-2 col-lg-2 col-md-2 col-sm-4
hasModal bool show larger image in a modal when clicked true
showControl bool show next / previous buttons in modal true
shortText bool truncate text to a single line in grid true


Install gulp and dependencies:

npm i -D gulp gulp-sass gulp-sourcemaps gulp-clean-css

run gulp compress to minify js and css

Change Log:

Update 1/6/2018: Support for Bootstrap 4 has been added. BS4 has made several changes and removed plenty of old functionality - so the plugin had to be updated.

  1. Removed Glyphicons. Embedded svg code for the icons for the modal controls

  2. Images in the gallery are now using background images - with fixed height. Background images with "cover" positioning is better than using images + resizing = especially for mobile

  3. Added a new option "shortText". This is for the caption to be truncated to a single line if set to true.

  4. Moved demo styles to plugin. This just makes sense. If you need to update - update the CSS file.

  5. Removed fullHeight option

  6. Made classes more unique to the plugin

Update 6/24/2016: Several enhancements have been made to the plugin. See the following list for the most recent changes:

  1. The Modal box that opens is always going to be the large modal. Images will scale up to 100% to fill the entire modal box. You still have the option of having a small thumbnail and linking to a different image for the large size - mainly for performance purposes.

  2. A new plugin option called "fullHeight" that allows you to have different heights in the thumbnails inside the grid. Most people want to see uniform heights, so I default this value to "true". If you want to see dynamic heights, simply set this to "false". Note that this doesn't affect the modal images.

  3. I've separated the styles into it's own stylesheet. You now have to include this stylesheet in your document, or you can simply copy the contents into your own stylesheet. I tried making everything inline so you only have to include the JS file, but it's been growing and having an external CSS is the only way to manage.

  4. Added glyphicons for the "Next" and "Previous" links in the modal. This just looks better.

  5. Images are required to have an alt tag, so I'm outputting the value of this into the modal as the title.

  6. You can have additional text underneath the grid thumbnails by having a "p" tag with a class of "text". I grab this value and put it in the modal as well.

Update 12/13/2015: I've updated the plugin to support linking to a different image when shown in the modal box. Continue reading below for instructions.

Update 11/14/2015: This code for this tutorial have been converted into a jQuery plugin. This means that it's now easier to create a responsive photo gallery. The original tutorial is still available below (where is says "Original Tutorial"). Note that you don't need to follow it if you're using the plugin. But it's good to know the inner workings of Bootstrap regardless.

The original (and outdated) tutorial can be found here:

"How to create a responsive photo gallery using Bootstrap" : http://michaelsoriano.com/create-a-responsive-photo-gallery-with-bootstrap-framework/


"Let’s Add Next and Previous Buttons to our Bootstrap Photo Gallery" http://michaelsoriano.com/next-and-previous-buttons-bootstrap-photo-gallery/