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.

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

Still need help? #

Send us your WordPress version, theme, Galleryberg version and a link to the page through the contact page. 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? #

Does Galleryberg work with caching plugins? #

Updated on November 14, 2026

What are your feelings

  • Happy
  • Normal
  • Sad