---
title: "Galleryberg Settings Reference: Every Option Explained"
description: A complete list of Galleryberg Gallery and Image block settings with their options and default values.
url: "https://galleryberg.com/docs/galleryberg-settings-reference/"
updated: "2026-11-14"
category: Reference
---

# Galleryberg Settings Reference: Every Option Explained

> **At a glance:** Every setting in the Galleryberg Gallery and Image blocks, with exact labels and defaults · Last checked: Galleryberg 1.2.1 and Pro 1.2.1 (November 2026)

This page lists every setting in the Galleryberg Gallery block and the Galleryberg Image block, using the same labels you see in the WordPress editor. Gallery settings are in the right sidebar when the whole gallery is selected. Image settings appear when you click a single image inside the gallery. Settings marked (Pro) need Galleryberg Pro.

## Gallery toolbar

| Button | What it does |
| --- | --- |
| Add | Adds more images to the gallery. |
| Shuffle images | Reorders the images randomly once. The new order is saved. |
| Convert captions | Converts every image caption into blocks so you can use headings and paragraphs. |
| Align | Sets the gallery to wide or full width, if your theme supports it. |

## Settings panel

| Setting | Options and range | Default |
| --- | --- | --- |
| Gallery Layout | Tiles, Masonry, Justified, Square, Mosaic (Pro), Carousel (Pro) | Tiles |
| Row Height (px) | 60 to 400, Justified layout only | 180 |
| Columns (Desktop) | 1 to 8, screens wider than 1024px | 3 |
| Columns (Tablet) | 1 to 8, screens 768px to 1024px. Empty uses the desktop value. | Empty |
| Columns (Mobile) | 1 to 8, screens narrower than 768px. Empty uses the tablet value. | Empty |
| Enable Hover Effect | On or off | Off |
| Hover Effect | Zoom In, Zoom Out | Zoom In |
| Enable Lazy Loading (Pro) | Loads images only when they scroll into view | Off |
| Randomize order on page load (Pro) | New random order on each page load, works behind caching | Off |

## Carousel Settings panel (Pro)

| Setting | Options and range | Default |
| --- | --- | --- |
| Slides to Show | Desktop (above 1024px), Tablet (768px to 1024px), Mobile (below 768px) | 3, 2, 1 |
| Slide Spacing | Gap between slides in pixels | 16 |
| Loop | On or off | On |
| Show arrows | On or off | On |
| Show dots | On or off | On |
| Draggable | On or off | On |
| Transition speed (ms) | Animation length in milliseconds | 500 |
| Autoplay | On or off | Off |
| Autoplay delay (ms) | Time per slide in milliseconds | 3000 |

## Lightbox panel

| Setting | Options and range | Default |
| --- | --- | --- |
| Enable Lightbox | On or off | Off |
| Open Effect | Zoom, Fade, None | Zoom |
| Close Effect | Zoom, Fade, None | Zoom |
| Slide Effect | Animation used when moving between images | Slide |
| Keyboard Navigation | Arrow keys move between images, Esc closes | On |
| Loop | After the last image, continue from the first | On |
| Zoomable | Visitors can zoom into the image | On |
| Draggable | Visitors can drag and swipe between images | On |
| Show captions in lightbox | Shows the caption below the image in the lightbox | Off |
| Enable Thumbnails (Pro) | Shows a thumbnail strip in the lightbox | Off |
| Thumbnail Position (Pro) | Bottom, Top, Left, Right | Bottom |
| Thumbnail Navigation (Pro) | Direct (Instant), Step by Step | Direct (Instant) |
| Navigation Speed (Pro) | Milliseconds between each step, for Step by Step | 10 |

## Comments panel (Pro)

| Setting | Options and range | Default |
| --- | --- | --- |
| Enable comments | Visitors comment on each image in the lightbox. Needs the lightbox. | Off |
| Show comment count on thumbnail | Badge on images that have comments | On |
| Open comments by default | Panel already open when the lightbox opens | Off |
| Include comment text in page HTML | Adds up to 20 approved comments per image to the page, hidden, for search engines | Off |
| Panel behaviour on desktop | Push (shrink the image), Overlay (float over the image) | Push |
| Panel width on desktop (px) | 300 to 480 | 360 |

## Caption Settings panel

| Setting | Options and range | Default |
| --- | --- | --- |
| Show Captions | Shows captions for all images using the gallery settings. Individual image caption controls are then disabled. | On |
| Caption Type | Below Image, Full Overlay, Bar Overlay | Full Overlay |
| Caption Visibility | Always Visible, Show on Hover, Hide on Hover | Always Visible |
| Caption Alignment | Left, Center, Right for Below Image. Overlay captions use the position grid in the toolbar. | Bottom center |

## Styles tab (gallery)

| Section | Controls |
| --- | --- |
| Typography | Caption Font Size, Caption Appearance, Caption Line Height, Caption Letter Spacing, Caption Text Decoration, Caption Text Transform (hidden until added) |
| Color | Background, Caption Color, Caption Background (default is a black-to-transparent gradient). Carousel adds Arrow Color, Dot Color (Active), Dot Color (Inactive). |
| Dimensions | Block Spacing (row and column gap, default 16px), Padding, Margin |
| Border | Border, Border Radius, Images Border Radius, Shadow, Images Shadow. Shadow presets come from your theme. |

## Image block settings

| Setting | Options and range | Default |
| --- | --- | --- |
| Alternative Text | Describes the image for screen readers and search engines | Empty |
| Focal Point | The part of the image that stays visible when it is cropped | Center (50%, 50%) |
| Aspect ratio | Original, Square 1:1, Standard 4:3, Portrait 3:4, Classic 3:2, Classic Portrait 2:3, Wide 16:9, Tall 9:16 | Original |
| Scale | Cover, Contain. Used when an aspect ratio crops the image. | Not set |
| Width and Height | Custom size in pixels, or Auto | Auto |
| Resolution | Thumbnail, Medium, Large, Full Size | Large |
| Enable Lazy Loading (Pro) | Lazy load only this image | Off |
| Mosaic Column Span and Mosaic Row Span (Pro) | How many columns and rows the image takes in the Mosaic layout | 1 |
| Disable comments on this image (Pro) | Hides the comments panel for this image | Off |
| Caption Settings | Caption Type, Caption Visibility, Caption Alignment for this image only | Gallery setting |
| Styles | Border, Border Radius, Shadow, duotone filter, caption colors and typography | None |

## Image toolbar

| Button | What it does |
| --- | --- |
| Bold, Italic, Link (in the caption) | Formats selected caption text |
| Change caption position | Position grid for overlay captions |
| Convert | Converts this caption into blocks |
| Link | Sets a custom link for the image |
| Crop | Crops the image in the editor |
| Replace | Swaps the image for another one, keeping its settings |

## Related docs

- [Galleryberg Core vs Pro](https://galleryberg.com/docs/galleryberg-core-vs-pro/)
- [Creating Your First Gallery](https://galleryberg.com/docs/creating-your-first-gallery/)
- [Galleryberg FAQ](https://galleryberg.com/docs/galleryberg-faq/)

## Frequently asked questions

### **Where are the Galleryberg gallery settings?**

Select the gallery by clicking the Galleryberg icon in the block toolbar. The settings appear in the right sidebar in panels: Settings, Lightbox, Comments (Pro), Caption Settings and, for the Carousel layout, Carousel Settings. Colors, spacing, borders and shadows are in the Styles tab.

### **How many columns can a Galleryberg gallery have?**

From 1 to 8 columns. You can set a different number for desktop, tablet and mobile.

### **What is the default Galleryberg layout?**

Tiles. New galleries start with the Tiles layout, 3 columns on desktop, 16px gaps and Full Overlay captions.

### **Is the Galleryberg lightbox on by default?**

No. Turn on Enable Lightbox in the Lightbox panel for each gallery where you want it.
