jQuery Lightbox Evolution


By aeroalquimia

If you have any question that are beyond the scope of this help file, please feel free to join the discussion or email me via my user page contact form. Thanks so much!

Table of Contents

  1. Single Image
  2. Image Gallery
  3. Big Images
  4. Advanced Examples
  1. Inline Content
  2. Ajax
  3. Flash / SWF
  4. Iframe
  5. Advanced Examples
  1. Simple Usage
  2. Advanced Examples
  1. Simple Usage
Advanced Examples
  1. Custom Buttons
  2. Shake Effect
  3. Login Box
  4. Open Lightbox via Javascript
  5. Events
Frequently Asked Questions
Support Notes

Images Back to top

Single Image

<a href="assets/1.jpg" class="lightbox"><img src="assets/m1.jpg" alt=""/></a>
<a href="assets/2.jpg" class="lightbox"><img src="assets/m2.jpg" alt=""/></a>
<a href="assets/7.jpg" title="Image Description" class="lightbox"><img src="assets/m7.jpg" alt=""/></a>

Image Gallery

Galleries are created from elements who have the same "rel" tag.

<a href="assets/5.jpg" class="lightbox" rel="group1"><img src="assets/m5.jpg" alt=""/></a>
<a href="assets/9.jpg" class="lightbox" rel="group1"><img src="assets/m9.jpg" alt=""/></a>
<a href="assets/6.jpg" class="lightbox" rel="group1" title="Lorem ipsum dolor sit amet..."><img src="assets/m6.jpg" alt=""/></a>

Big Images

Big images are resized to be completely visible

<a href="assets/4.jpg" class="lightbox"><img src="assets/m4.jpg" alt=""/></a>
<a href="assets/8.jpg" class="lightbox"><img src="assets/m8.jpg" alt=""/></a>

Advanced Examples

Force Size

<a href="assets/3.jpg?lightbox[width]=400&lightbox[height]=200" class="lightbox"><img src="assets/m3.jpg" alt=""/></a>
<a href="assets/6.jpg?lightbox[width]=300&lightbox[height]=200" class="lightbox"><img src="assets/m6.jpg" alt=""/></a>
Relative Size

<a href="assets/5.jpg?lightbox[width]=50p&lightbox[height]=50p" class="lightbox"><img src="assets/m5.jpg" alt=""/></a>
<a href="assets/2.jpg?lightbox[width]=100p&lightbox[height]=100p" class="lightbox"><img src="assets/m2.jpg" alt=""/></a>
Disable AutoResize

<a href="assets/9.jpg?lightbox[autoresize]=false" class="lightbox"><img src="assets/m9.jpg" alt=""/></a>
<a href="assets/4.jpg?lightbox[autoresize]=false" class="lightbox"><img src="assets/m4.jpg" alt=""/></a>
Open in Modal

Toggle if clicking the overlay shouldn't close Lightbox.

<a href="assets/5.jpg?lightbox[modal]=true" class="lightbox"><img src="assets/m5.jpg" alt=""/></a>

HTML Back to top

Inline Content

id="loremipsum" Nullam varius congue fringilla. Curabitur auctor dapibus molestie. Cras malesuada vestibulum lectus, vel ullamcorper nibh tempus lobortis. Donec ipsum magna, malesuada et fringilla eget, placerat ut arcu. Donec aliquet, mauris ut pellentesque tincidunt, massa dolor tempor urna, ac interdum massa nisl id tellus. Maecenas eu nunc varius lorem porttitor faucibus. Suspendisse potenti. Donec ullamcorper vehicula pretium. In aliquam adipiscing mi, rhoncus eleifend felis auctor eu. Aenean et mi vitae ante ultricies pulvinar a vel neque.

Open LoremIpsum | Open LoremIpsum with fixed size (524x178)

<a href="#loremipsum" class="lightbox">Open LoremIpsum</a>
<a href="?lightbox[width]=524&lightbox[height]=178#loremipsum" class="lightbox">Open LoremIpsum with fixed size (500x250)</a>


Open Ajax with fixed size (350x170) | Open Ajax with relative size (75% x 50%) | Open Video in Modal

<a href="examples/ajax-html.html?lightbox[width]=350&lightbox[height]=170" class="lightbox">Open Ajax with fixed size (350x170)</a>
<a href="examples/ajax-html.html?lightbox[width]=75p&lightbox[height]=50p" class="lightbox">Open Ajax with relative size (75% x 50%)</a>
<a href="examples/ajax-video.html?lightbox[width]=610&lightbox[height]=360&lightbox[modal]=true" class="lightbox">Open Video in Modal</a>

Flash / SWF

<a href="http://www.adobe.com/jp/events/cs3_web_edition_tour/swfs/perform.swf" class="lightbox">flash</a>


Open Google | Open Localhost Iframe

<a href="http://www.google.com/webhp?hl=en&tab=nw&lightbox[iframe]=true&lightbox[width]=770&lightbox[height]=460" class="lightbox">Open Google</a>
<a href="examples/iframe-html.html?lightbox[iframe]=true&lightbox[width]=350&lightbox[height]=170" class="lightbox">Open Localhost Iframe</a>

Advanced Examples

Open flash in fixed size

<a href="http://www.adobe.com/jp/events/cs3_web_edition_tour/swfs/perform.swf?lightbox[width]=700&lightbox[height]=400" class="lightbox">flash</a>
Ajax with button to close the lightbox

Software license agreement

<a href="examples/ajax-license.html?lightbox[width]=450&lightbox[height]=300&lightbox[modal]=true" class="lightbox">Software license agreement</a>

Videos Back to top

Simple Usage

<a href="http://www.youtube.com/watch?v=5f-MYl-HzNw" class="lightbox">youtube</a>
<a href="http://vimeo.com/13240711" class="lightbox"><img src="assets/m13.jpg" alt=""/>vimeo</a>
<a href="http://www.metacafe.com/watch/yt-nn096G5jek0/coldplay_speed_of_sound_acoustic/" class="lightbox">metacafe</a>
<a href="http://www.dailymotion.com/video/x53dvz_fragma-toca-s-miracle-2008_music" class="lightbox">dailymotion</a>
<a href="http://video.google.com/videoplay?docid=-8618166999532839788" class="lightbox">google video</a>

Advanced Examples

Open video in fixed size and modal

<a href="http://video.google.com/videoplay?docid=1299927595688205543&lightbox[width]=610&lightbox[height]=360" class="lightbox">google video</a>
<a href="http://www.youtube.com/watch?v=Mq0j2Ot1NHo&lightbox[width]=610&lightbox[height]=360&lightbox[modal]=true" class="lightbox">youtube</a>

Maps Back to top

Simple Usage

| |

<a href="http://maps.google.com/maps?f=q&source=s_q&hl=en&geocode=&q=+paris+eiffel&ie=UTF8&hq=eiffel&hnear=Paris,+Ile-de-France,+France&ll=48.855708,2.300434&spn=0.013243,0.042272&z=15&lightbox[width]=610&lightbox[height]=360" class="lightbox">Google Maps</a>
<a href="http://maps.google.com/maps?f=q&source=s_q&hl=en&geocode=&q=+paris+eiffel&ie=UTF8&hq=eiffel&hnear=Paris,+Ile-de-France,+France&ll=48.856075,2.312021&spn=0.02626,0.084543&z=14&layer=c&cbll=48.85738,2.294552&panoid=CpyaiHG57nbMr8YogDfa0Q&cbp=12,34.51,,0,-2.58&lightbox[width]=610&lightbox[height]=360" class="lightbox">Street View</a>
<a href="http://www.bing.com/maps/?v=2&cp=41.89774457054518~12.471384108066559&lvl=15&sty=r&where1=Rome%2C%20Laz.%2C%20Italy&lightbox[width]=610&lightbox[height]=360" class="lightbox">Bing Maps</a>

Advanced Examples Back to top

Custom Buttons

<style type="text/css">
  .jquery-lightbox-buttons .jquery-lightbox-button-openurl
    background: url(assets/lightbox-new-window.png) no-repeat left top;

  .jquery-lightbox-buttons .jquery-lightbox-button-openurl:hover
    background: url(assets/lightbox-new-window.png) no-repeat right top;
<script type="text/javascript">

      buttons: [
          'class'     : 'jquery-lightbox-button-openurl',
          'html'      : '<span>open in new window</span>',
          'callback'  : function(url, object) {
            window.location.href = url;

<a href="assets/1.jpg" class="customlightbox"><img src="assets/m1.jpg" alt=""/></a>
<a href="assets/7.jpg" class="customlightbox"><img src="assets/m7.jpg" alt=""/></a>
<a href="assets/9.jpg" class="customlightbox" rel="group2"><img src="assets/m9.jpg" alt=""/></a>
<a href="assets/6.jpg" class="customlightbox" rel="group2"><img src="assets/m6.jpg" alt=""/></a>

Custom Buttons - ThemeForest example

<style type="text/css">
  .jquery-lightbox-buttons .button-themeforest

  .jquery-lightbox-buttons .button-themeforest:hover
<script type="text/javascript">
      buttons: [
          'class'     : 'button-themeforest',
          'html'      : 'Live Preview',
          'callback'  : function(url, object, anchor) {
            title = jQuery(anchor).attr('alt').split('|');
            window.location.href = title[0];
          'class'     : 'button-themeforest',
          'html'      : 'Buy this theme',
          'callback'  : function(url, object, anchor) {
            title = jQuery(anchor).attr('alt').split('|');
            window.location.href = title[1];
<a href="assets/17.jpg" class="themeforest" rel="group3" alt="http://themeforest.net/item/freshface-html-css/full_screen_preview/109603|http://themeforest.net/item/freshface-html-css/109603"><img src="assets/m17.jpg" alt=""/></a>
<a href="assets/18.jpg" class="themeforest" rel="group3" alt="http://themeforest.net/item/perfect-box-wordpress/full_screen_preview/101974|http://themeforest.net/item/perfect-box-wordpress/101974"><img src="assets/m18.jpg" alt=""/></a>

Shake effect

Shake Effect

<a href="examples/ajax-html.html?lightbox[width]=350&lightbox[height]=170" class="lightbox">Shake Effect</a>


Login Box

Login Box

<a href="examples/ajax-login.html?lightbox[width]=396&lightbox[height]=120&lightbox[modal]=true" class="lightbox">Login Box</a>

Open Lightbox via Javascript

<input type="submit" class="button" id="lbsingle" value="Open single image"/>
<input type="submit" class="button" id="lbgallery" value="Open gallery"/>
<script type="text/javascript">
    jQuery("#lbsingle").click(function(ev) {
      jQuery.lightbox("assets/4.jpg", {
        'width'       : 610,
        'height'      : 458,
        'autoresize'  : false

    jQuery("#lbgallery").click(function(ev) {
      jQuery.lightbox(["assets/4.jpg", "assets/3.jpg", "assets/6.jpg"]);



jQuery("#lbevents").click(function(ev) {

  jQuery.lightbox("assets/2.jpg", {'modal': true}, function() {
    jQuery("#console").append("<p>'callback' function fired.</p>");



Events fired:

Frequently Asked Questions Back to top

  1. Can I use this script on my client's website?

    Yes. Your license includes the rights to use the script on any one website at a time. If you'd like to use the script as part of a service, please consider purchasing an Extended License.

  2. Can I make modifications to this script?

    Feel free to make any modifications you need. Also feel free to blog about it and show your friends, but please do not redistribute the script with your changes.

  3. Why the script doesn't work?

    Make sure you don't have multiple versions of jquery in your page. Look at the source view in your browser to see what jscripts you are loading.

    For example:

    <script src="crazy_path/jquery.js" type="text/javascript"></script>
    <script src="crazy_path/jquery.min.js" type="text/javascript"></script>
    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>

    jquery.js and jquery.min.js are the same script. Delete the last one if you can. Keep only one.

  4. The shadow overlay doesn't stretch to cover full browser window.

    Remove the default margin and padding from the body tag. Add body{ margin: 0; padding: 0; } to your stylesheet.

  5. How to automatically start Lightbox on page load?

    Simply add the following code:

  6. <script type="text/javascript">
  7. Why Flash objects appear through overlay?

    By default Flash will overlay any HTML content. This can be prevented by setting the 'wmode' param and embed attribute to 'transparent'.

    For more information from Adobe Support

    AC_FL_RunContent( 'codebase', 'http...', 'pluginspage', 'http...',  'wmode', 'transparent', 'width', '99', 'height', '99', 'src', 'images/home', 'quality', 'high' );
    var so = new SWFObject("home.swf", "home", "99", "99", "9", "#222222");
    so.addParam("allowfullscreen", "true");
    so.addParam("allowScriptAccess", "always");
    <object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http..." width="999" height="999">
      <param name="movie"   value="images/home.swf" />
      <param name="quality" value="high" />
      <param name="wmode"   value="transparent" />
      <embed src="images/home.swf" wmode="transparent" width="999" height="999" quality="high" pluginspage="http..." type="application/x-shockwave-flash"></embed>
  8. Lightbox is positioned incorrectly or behaving strangely in Internet Explorer

    This is likely a doctype issue. This plugin requires a valid doctype and rendering in quirks mode is not supported. Make sure you are using the full doctype declaration to insure rendering in standards mode.

    This abbreviated doctype renders the document in quirks mode for Internet Explorer:

    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

    The doctype with URI renders in standards mode for all browsers:

    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  9. How can I open Lightbox from inside a Flash movie?

    In your Flash movie you need to use getURL to call your custom callback function, like so:

  10. How can I open Lightbox in parent window from inside an iframe?

    First thing you need to do is install the script in your parent window, but don't initialize it. Don't use jQuery(document).ready, instead, add the code below:

    <script type="text/javascript">
      function frameload(iframe) {
        var doc = iframe.contentWindow || iframe.contentDocument;
        if (doc.document) { doc = doc.document; };
        jQuery('.lightbox', doc.body).lightbox();

    Insert onload="frameload(this);" in your iframe markup.

    <iframe src="iframe_child.html" onload="frameload(this);" width="500" height="500"></iframe>     

    When you click an image in the child page, the lightbox will be displayed in your parent page. Remember to remove the script in your child page to avoid any problem.

  11. Any plans for making it available for Wordpress?

    Click !

Support Notes Back to top

To be able to help solve a problem quickly, please read the entries below. I'll do my best to assist you. I provide a full range of Support except:

  1. I don't (and can't) support the 3rd-party code (i.e. external plugins, javascripts, flash players, etc.) In such cases you shall have to contact the authors.
  2. I don't support errors provoked by the strong modification of the original packages.
  3. I don't customize the packages in personal way.
  4. If you sure that your improvement ideas will be helpful to others, please don't hesitate to share it with me. Most likely that it will became a free package update.

If you have a more general question relating to scripts on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section. Once again, thank you so much for purchasing this plugin.

aeroalquimia (Eduardo Daniel Sada)
Buenos Aires, Argentina. Jul 2010