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.

        	jQuery('.pa-gallery .et_pb_gallery_item:nth-child(1) img').click();


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

Leave A Response!

By commenting you agree to our Blog & YouTube Comments Policy


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="" 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.

    • Hemant Gaba

      Hi Arlene!

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

  2. Glenn Lidstone <span class="comment-author-role-label"><a href="" 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!

    • Hemant Gaba

      We will look into it and provide an alternative solution


Comments By Others

  1. 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.

    • Hemant Gaba

      Hi Athirah!

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

  2. 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 –

    • Hemant Gaba

      Hi Ben!

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

  3. 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.

  4. 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??

    • Hemant Gaba

      Hi Derek!

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

  5. 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?

    • Hemant Gaba

      Hi Gavin!

      Can you please share the URL of the page to investigate further?

  6. 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?

    • Hemant Gaba

      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.

  7. Tom Vallone

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

    • Hemant Gaba

      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!

      • Arlene Seydoux <span class="comment-author-role-label"><a href="" 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

        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!

  8. 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.

    • Hemant Gaba

      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!

  9. Andres

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

    • Hemant Gaba

      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.


Submit a Comment

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

Recent Posts


Your Cart