Subscribe On YouTube

Join other subscribers and enjoy other Divi video tutorials!

How To Open A Divi Gallery Lightbox By Clicking Any Button, Image, Or Link

Nelson Miller Profile Orange
In this tutorial I will show you how to open a Divi gallery in a lightbox by clicking on a button, image, link, or other module.

Open A Gallery Lightbox From Anywhere

Have you ever wanted to open a gallery of images in a lightbox, but didn’t want to display the gallery on the actual page? Now you can! We wanted to do this too, so we created the solution. In this tutorial, I will show you how to open a Divi gallery in a lightbox by clicking on a button, image, link or other module.

▶️ Please watch the video above to get all the exciting details! 👆

1. Add And Set Up A Divi Gallery Module

Add The Module And Images

The first step is to place a Divi Gallery module in your layout and add your images.

Hide The Gallery

For this tutorial, we will be hiding the Divi Gallery module from view because we only want to see the images from the gallery opened in a lightbox. So the next step is to hide the module by going to the Divi Gallery settings>Advanced tab>Custom CSS and placing the code “display: none!important;” into the Main Element code box.

hide the Divi gallery from page to open images in lightbox

Add A Custom CSS Class

The last step for the Divi Gallery module is to add a CSS class so that our jQuery code in the next step can target this exact gallery to open the images in a lightbox.

Go to the Gallery module settings>Advanced tab>CSS ID & Classes toggle and add the class “pa-gallery” to the CSS Class input field.

add css class to open a Divi gallery from button image or link click

2. Add And Set Up The Trigger Module

Add The Module

Now you need to decide what kind of module or link you want to open the gallery. You could use an image that opens the lightbox, or a button, or any other module. In the video accompanying this tutorial, we will show you an example with both an Image module and a Button module.

Add A Custom CSS Class

The trigger module needs to have a CSS class also. This one is used to designate the module as the click rigger that opens the gallery lightbox. (The screenshot below shows the example using a Button module.)

Go to the module settings>Advanced tab>CSS ID & Classes toggle and add the class “pa-gallery-trigger” to the CSS Class input field.

add css class to click trigger open a Divi gallery from button image or link

If you wanted to just is a link within your text you could add the class to the href <a> tag like this:

<a class="pa-gallery-trigger" href="#">Open Gallery From Link</a>

3. Add The jQuery Snippet

The last step is to copy and paste the jQuery snippet below into your site. The code is simply opening the Divi Gallery module whenever you click on the trigger module.

If you are using our free Divi child theme, place this snippet into the scripts.js file and remove the <script> tags at the beginning and end. Otherwise, place this in your Divi>Theme Options>Integrations tab in the “Add code to the < head > of your blog” code area.

<Script> 
jQuery(document).ready(function(){
        jQuery('.pa-gallery-trigger').click(function(){
        	jQuery('.pa-gallery .et_pb_gallery_item:nth-child(1) img').click();
        });
 });

</Script>

You may notice the :nth-child(1) in the code. This refers to the image that should open as the default image. So in this case, the 1 means the very first image in the gallery, or you could choose any other number to open another image first.

Subscribe For More Things Like This!

At the start of each month, we send out a recap newsletter from the month before with family news, Divi news, our latest tutorials, and product news. Occasionally, if the news is too exciting to wait, we will send out another email separate from the monthly newsletter. That’s what you get when you subscribe, and of course you can unsubscribe if you are no longer interested!

Blog Post Optin
Divi Logo (2)

Shop Our Divi Products

Plugins • Courses • Templates

Visit The Shop

Featured Products

Asset 4

New! Trail Guides

Follow a series of blog posts carefully arranged around a specific topic or goal! Keep track of your progress by marking posts completed, just like a free course!

View Trial Guides

Divi Tutorials On YouTube

Our videos have views! Join subscribers and enjoy over video tutorials!

Visit Our Channel

Leave A Response!

By commenting you agree to our Blog & YouTube Comments Policy

33 Comments

Comments By Members

These comments are highlighted because they were posted by fans who have a membership on this site.

  1. Arlene <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

    It seems there is a definite need for a solution like this, but in a more dependable form (plugin?) Specifically, a plugin that would use any trigger to pop up a gallery or slideshow.

    Triggering a gallery from a single gallery item is not always as straightforward for the user as you might think, i.e. they don’t always try to do click on the image and clients prefer that I use a trigger based on a button. Currently I address this with a popup overlay plugin, but I find the entire process of creating and managing the overlays very clunky – I suspect that plugin was created more for “one time on a page” kinds of popups.

    I am wary of doing lots of things with code for clients websites, because I invariably forget how I did it (despite tech notes!) As I manage several clients with multiple galleries on pages, I would be interested in a more dependable solution to this conundrum. From what I have read, others are, too. I have searched a lot for an alternative to the popup overlay scenario, and it just doesn’t exist.

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Arlene!

      Thank you for the detailed feedback. We will add the plugin requests in our features list.

      Reply
  2. Glenn Lidstone <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

    Awesome tutorial and is exactly what I was looking for. Someone mentioned in the previous comments what about multiple galleries on the page and in my case I’m going to have quite a number of them, so the solution of unique JS for each gallery is not likely optimal. I suspect the code can be adjusted for multiple galleries and I’ll look at doing that. Anyway, I do appreciate this tutorial and PeeAyeCreative’s indispensable set of plugins! Keep up the good work, sir!

    Reply

Comments By Others

  1. Rebekah Gibson

    Hi! I followed all of the instructions to the best of my ability, but now the code is appearing at the top of my website as a string. What can I add to the code or change to make it hidden again? Website is stelcoscrapmetal.com for reference. Thank you!

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Rebekah!

      I’ve checked the homepage and not able to see any code at the top. Seems the issue is resolved. Let me know if it is happening on any other page.

      Reply
  2. Athirah

    Hi Hemant,
    Thank you for the tutorial! I works on my site but only when I open via desktop. When I try open through phone, the gallery does not showing.

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Athirah!

      The customization should work fine on mobile devices. Can you please share the URL of the page to check further?

      Reply
  3. Bea Nicholson

    This is exactly what I need and this is a great tutorial, but I seem to be having trouble with the gallery opening. I’ve tried by adding the jquery code in a code module and alternatively in theme options, to no avail. Here is the link – https://thebeaglealliance.org/elea/

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Ben!

      I have checked the page source code and not able to find any Gallery module. Did you remove it?

      Reply
  4. Sean

    I have 14 different galleries to open into lightboxes that I would like to set up on my page. Is there a way I can just upload one gallery and code each button to only open a certain number of gallery images? IE Column one button one opens pictures 1 thru 4, Column 2 button 2 opens pictures 5 – 9 etc.

    Reply
  5. Derek P

    Thanks for this tutorial.
    I want to launch a video playing in a light box vs a gallery. Will this code work for that as well??

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Derek!

      Could you please share some more details of the setup you have for the video lightbox and share the page URL?

      Reply
  6. Gavin Crawford

    Thank you for a great tutorial! I have a site where I added six galleries on two different pages. Everything works fine on desktop/laptop, but not so well on an ipad or iphone. The first image opens up fine on both the ipad and phone, but then gets stuck on that first image. I can’t go to the next image, and can’t close the image that’s open, either. I have to refresh the page, which closes the gallery. Have you come across this issue? If so, were you able to find a fix?

    Reply
  7. Ivan

    Hi Hemant

    As soon as I add the “display: none!important;” the module disappears, as it should, but I’m unable to modify it any further. It does not go semi transparent like in the video. Any solution?

    Reply
    • John Parker

      One solution is to switch the view to wireframe. From the Divi Builder screen, click on the blue button at the bottom center and a small set of icons appears on the bottom left so that you can see what your page looks like in desktop, tablet or mobile view. One of those buttons is a wireframe view. In wireframe you can see all the sections and modules, even the ones set to ‘display: none’, and you can access the settings for each.

      Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Ivan!

      In the video, we have used the Divi visibility option to disable the module across just to show the Gallery present in the builder. You can use that as well. We provided !important code to make sure the gallery is hidden on live page. The Divi visibility option don’t add !important in its CSS and can be overrided sometimes by any other code.

      Reply
  8. Tom Vallone

    Why when the lightbox is opened does the screen return to the top of the page?

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Tom!

      It is happening due to default nature of the anchor link. We’ll check for alternative solution to stop loading of the anchor link and update the guide soon. Stay tuned!

      Reply
      • Deb

        I added this to the jquery before the call to open the gallery – “e.preventDefault();” (don’t forget to add the “e” to the first line function()). The code now looks like this:

        jQuery(‘.pa-gallery-trigger1’).click(function(e){
        e.preventDefault();
        jQuery(‘.pa-gallery .et_pb_gallery_item:nth-child(1) img’).click();
        });

        To make sure the mouse changes to look like a link, I added this additional class for all the buttons/images I’m using to open the gallery lightbox making the css for each appear as “pa-gallery-triggers pa-gallery-trigger1”, etc:

        .pa-gallery-triggers {
        cursor: pointer;
        }

        Hope this helps!

      • Arlene Seydoux <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

        Did you find a solution to this? I am using buttons and several galleries on a page. Not sure where I would put “#pa-gallery-trigger” as one person indicated below. This would probably work for a text link where you can edit HTML but I can’t find the appropriate place on a button…
        Thanks for any help

      • Bevi

        I solved the issue by putting #pa-gallery-trigger in the anchor.

      • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

        I’m glad the solution worked fine for you. Thank you for sharing it with us!

      • Ryan McGuire

        Just some quick follow-up: I’m working past the scroll by eliminating the href tag. Yes, this gets rid of the indication that the link is clickable but the lightbox opens just fine.

      • Ryan McGuire

        Glad to see you’re working on this – I had the exact same question. Thank you for this excellent guide!

  9. Paul

    Hello Nelson

    Thanks for your great tutorial.
    I would like to know how to display the caption (or description) of the image, under the photo in the lightbox. THANKS.
    (Maybe in a future tutorial.
    ;-)…)

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Paul!

      By default it will only show the title below the image lightbox. So you can just key in your ‘caption’ as title. However, we will consider this feature and provide a solution soon. Stay tuned!

      Reply
      • Deb

        I tried adding my caption (which the client wants to be a link to the PDF version of the image), however, it does not display a link, but the code.

  10. Andres

    What if I want to add more than 1 gallery in the same page??

    Reply
    • Hemant Gaba <span class="comment-author-role-label"><a href="https://www.peeayecreative.com/product/divi-adventure-club/" class="comment-author-role-link" rel="external nofollow" target="_blank">Divi Adventure Club Member</a></span>

      Hi Andres!

      In that case, please add a new class in the Gallery and new button module. Then add a new script with those classes.

      Reply

Submit a Comment

Your email address will not be published. Required fields are marked *

Recent Posts

Shopping cart0
There are no products in the cart!
You may be interested in…
$19.00$22.50

Select options This product has multiple variants. The options may be chosen on the product page

$16.50$24.00

Select options This product has multiple variants. The options may be chosen on the product page

$16.50$24.00

Select options This product has multiple variants. The options may be chosen on the product page

$19.00$24.00

Select options This product has multiple variants. The options may be chosen on the product page

$20.50$24.00

Select options This product has multiple variants. The options may be chosen on the product page

Graphic showcasing Divi Assistant features and toolset.
From: $69.00 / year

Select options This product has multiple variants. The options may be chosen on the product page

Divi Search Helper Plugin By Pee Aye Creative
From: $29.00 / year

Select options This product has multiple variants. The options may be chosen on the product page

Continue shopping
0