How To Open A Gallery Lightbox By Clicking Any Button Image Or Link Tutorial by Pee Aye Creative

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

Nelson Miller Pee Aye Creative
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.

Join subscribers on our YouTube channel and enjoy other Divi video tutorials!

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.

Last updated [last-modified %date%]


Each month we send out a roundup email newsletter with the latest tutorials, product updates, helpful resources, and any other industry or personal news. Occasionally we send an extra separate email here and there if we just can’t wait! So that’s what you will get if you subscribe, and you can always unsubscribe at any time if you just can’t take it anymore :)

Blog Post Optin

Please share this post!

Nelson Lee Miller (aka The Divi Teacher)

Nelson is the owner of Pee-Aye Creative in the beautiful state of Pennsylvania. He loves helping small businesses, exploring outdoors, building websites with Divi, and teaching others.

Leave A Response!

By commenting you agree to our Blog & YouTube Comments Policy


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

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

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

      • Ryan McGuire

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

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

      • Hemant Gaba

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

      • Bevi

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

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

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

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

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


Submit a Comment

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

Recent Posts


Your Cart