---
title: Troubleshooting Common Galleryberg Issues
description: Causes and fixes for the most common Galleryberg gallery problems.
url: "https://galleryberg.com/docs/galleryberg-troubleshooting/"
updated: "2026-11-14"
category: "Troubleshooting & FAQs"
---

# Troubleshooting Common Galleryberg Issues

> **At a glance:** Fixes for the most common Galleryberg problems · Always start by updating Galleryberg and Galleryberg Pro to the latest version (1.2.1) · Last checked: November 2026

Most Galleryberg problems come from one of four things: a setting that is off by default (like the lightbox), an outdated plugin version, a caching or JavaScript optimization plugin, or a Pro license that is not active. This page lists each common problem with its cause and fix. If you are still stuck, [contact support](https://galleryberg.com/contact).

## The lightbox does not open when I click an image

- **Enable Lightbox** is off. It is off by default. Select the gallery, open the **Lightbox** panel and turn it on.
- A JavaScript optimization feature (such as delaying, deferring or combining JavaScript in a caching plugin) is holding back the lightbox script. Exclude Galleryberg's scripts from that feature, then clear the cache.
- You are on an old version. Version 1.2.0 fixed the lightbox on touch devices, and 1.1.3 fixed it with Full Overlay captions. Update Galleryberg.

## The gallery looks different on the front end than in the editor

- Clear your caching plugin, server cache and CDN cache, then reload the page.
- Your theme or another plugin may add CSS to images or figures. Check any custom CSS that targets images.
- If the Justified layout row height looks wrong, update Galleryberg. Version 1.1.4 fixed the row height on the front end.

## Mosaic or Carousel shows "(Pro)" and I cannot select it

- Galleryberg Pro is not installed or active. Both plugins must be active: the core Galleryberg Gallery Block plugin and Galleryberg Pro.
- The license is not activated. See [Insert and Activate Your License Key](https://galleryberg.com/docs/insert-activate-your-license-key/).
- Update both plugins to the latest version.

## The lightbox says "Comments are not available for this image"

- The page is private, a draft or password protected. Image comments only work on published, public pages.
- **Enable comments** is off for that gallery, or **Disable comments on this image** is on for that image.
- The gallery uses a Dynamic Gallery (ACF or SCF) source. Comments are not available for dynamic galleries yet.

## Lazy loaded images stay on the grey placeholder

- Update Galleryberg Pro. Version 1.2.0 fixed images getting stuck on the placeholder.
- Exclude Galleryberg's scripts from JavaScript delay or defer features in your optimization plugin.

## The image order does not change with Randomize order on page load

- Check that **Randomize order on page load** is on for that gallery and that Pro is active.
- The shuffle runs in the browser. A JavaScript delay feature in an optimization plugin can stop it, so exclude Galleryberg's scripts.
- The order only changes on the front end. In the editor you always see the saved order.

## Captions are missing

- Check **Show Captions** in the **Caption Settings** panel and that the images actually have captions.
- If **Caption Visibility** is **Show on Hover**, captions appear only when the mouse is over the image. Touch screens have no hover, so use **Always Visible** or **Below Image** for important captions.

## Images look blurry

- The image **Resolution** is set too low. Select the image and set Resolution to **Large** or **Full Size**.
- The original file in the Media Library is small. Upload a larger version and use **Replace** in the image toolbar.

## I cannot find the Galleryberg block, or it does not work in my page builder

- Search for "Galleryberg Gallery" in the block inserter. Make sure the plugin is active.
- Galleryberg is built for the WordPress block editor (Gutenberg). It may not work inside page builders such as Elementor.

## The Dynamic Gallery says no ACF Gallery fields were found

- Install and activate ACF PRO or Secure Custom Fields (SCF), then create a field of type Gallery. See [Dynamic Galleries from ACF and SCF Fields](https://galleryberg.com/docs/dynamic-gallery-acf-scf/).

## Still need help?

Send us your WordPress version, theme, Galleryberg version and a link to the page through the [contact page](https://galleryberg.com/contact). Pro customers can also include their license email.

## Frequently asked questions

### **Why is my Galleryberg lightbox not working?**

Most often Enable Lightbox is off, because it is off by default. If it is on, a caching or optimization plugin may be delaying JavaScript. Exclude Galleryberg's scripts from that feature, clear the cache, and update Galleryberg to the latest version.

### **Why can I not select the Mosaic or Carousel layout?**

Those layouts need Galleryberg Pro. Make sure the core Galleryberg plugin and Galleryberg Pro are both active and your license key is activated.

### **Does Galleryberg work with caching plugins?**

Yes. Galleryberg works with page caching. If a feature that relies on JavaScript, such as the lightbox, lazy loading or random order, stops working, exclude Galleryberg's scripts from JavaScript delay or combine features.
