Captions let you display a title and description directly on each Gallery item — overlaid on the thumbnail or positioned above or below it. Every aspect of the caption is configurable per Gallery: where it sits, how it’s aligned, what text it draws from, and how each line of text looks.
Location Gallery Settings → Captions
Caption Type #
| Setting | Caption Type |
| Options | Default Custom (Pro Starter) |
| Default | Default |
Default uses the standard title and description fields configured in the sections below. Custom (Pro Starter) lets you write HTML templates with dynamic placeholders and integrations with ACF and Pods — see the Custom Captions article for details.
Caption Placement #
| Setting | Caption Placement |
| Options | Overlay Top Bottom |
| Default | Overlay |
Overlay renders the caption inside the thumbnail frame — typically used with a semi-transparent background applied via CSS. Top and Bottom place the caption outside the image, above or below it respectively. When either external placement is chosen, the Caption Distance from Media setting becomes available.
Caption Distance from Media #
| Setting | Caption Distance from Media |
| Default | 8px |
| Range | 0–16 |
| Units | px em rem |
| Visible when | Caption Placement is set to Top or Bottom |
Controls the gap between the image and the caption block when using an external placement. Has no effect when Caption Placement is set to Overlay.
Caption Alignment #
| Setting | Caption Alignment |
| Options | Left Center Right Justify |
| Default | Left |
Sets the horizontal text alignment for both the title and description lines within the caption block.
Item Title #
These settings control the title line of the caption.
Hide Title
| Setting | Hide Title |
| Options | on off |
| Default | off |
When on, the title line is removed from the caption entirely. All other title settings are hidden while this is enabled.
Title Source
| Setting | Title Source |
| Options | Item Title Item Caption Item Alt Item Description |
| Default | Item Title |
| Visible when | Hide Title is off |
Determines which field from the item’s metadata is used as the caption title. Each option pulls from a different field set in the item editor:
- Item Title — the item’s title field (defaults to the media file name if empty)
- Item Caption — the item’s caption field
- Item Alt — the item’s alt text field
- Item Description — the item’s description field
Title Color
| Setting | Title Color |
| Default | #000000 |
| Visible when | Hide Title is off |
Title Font Family
| Setting | Title Font Family |
| Default | Default (inherits theme font) |
| Visible when | Hide Title is off |
Title Font Weight
| Setting | Title Font Weight |
| Default | Default (inherits theme weight) |
| Visible when | Hide Title is off |
Title Font Size
| Setting | Title Font Size |
| Default | 18px (desktop) / 16px (tablet) / 14px (mobile) |
| Range | 8–72 (desktop), 8–48 (tablet), 8–36 (mobile) |
| Units | px em rem |
| Visible when | Hide Title is off |
Responsive — you can set different sizes for desktop, tablet, and mobile breakpoints independently.
Limit Title Length
| Setting | Limit Title Length |
| Options | No Yes — by character length Yes — by lines |
| Default | No |
| Visible when | Hide Title is off |
Truncates the title in thumbnails when it exceeds a set length. This setting only affects thumbnails — titles in the Lightbox info panel are not truncated.
When set to Yes — by character length:
| Setting | Max Title Characters |
| Default | 200 |
| Range | 20–400 |
| Visible when | Limit Title Length is Yes — by character length and Hide Title is off |
When set to Yes — by lines:
| Setting | Max Title Lines |
| Default | 1 |
| Range | 1–4 |
| Visible when | Limit Title Length is Yes — by lines and Hide Title is off |
Both Max Title Characters and Max Title Lines are responsive — you can set different values per breakpoint.
Item Description #
These settings control the description line of the caption, which appears below the title.
Hide Description
| Setting | Hide Description |
| Options | on off |
| Default | off |
When on, the description line is removed from the caption entirely. All other description settings are hidden while this is enabled.
Description Source
| Setting | Description Source |
| Options | Item Title Item Caption Item Alt Item Description |
| Default | Item Caption |
| Visible when | Hide Description is off |
Determines which field is used as the caption description. The available sources are the same as for Title Source — you can mix and match, for example showing the item title as the title line and the item caption as the description line.
Description Color
| Setting | Description Color |
| Default | #aaaaaa |
| Visible when | Hide Description is off |
Description Font Size
| Setting | Description Font Size |
| Default | 14px (desktop) / 12px (tablet) / 12px (mobile) |
| Range | 8–24 |
| Units | px em rem |
| Visible when | Hide Description is off |
Responsive — set different sizes per breakpoint.
Limit Description Length
| Setting | Limit Description Length |
| Options | No Yes — by character length Yes — by lines |
| Default | No |
| Visible when | Hide Description is off |
Truncates the description in thumbnails. As with the title, this does not affect how the description appears in the Lightbox.
When set to Yes — by character length:
| Setting | Max Description Characters |
| Default | 200 |
| Range | 20–400 |
| Visible when | Limit Description Length is Yes — by character length and Hide Description is off |
When set to Yes — by lines:
| Setting | Max Description Lines |
| Default | 2 |
| Range | 1–4 |
| Visible when | Limit Description Length is Yes — by lines and Hide Description is off |
Both Max Description Characters and Max Description Lines are responsive.
