Skip to content

Lightbox and captions

Open full-size images and show titles on your gallery

Use with AI

Use with AI

Ready-made prompts Connect your AI to Pasilobus Install the CLI

This page

View as MarkdownPlain text of this page Open in ClaudeAsk about this page Open in ChatGPTAsk about this page

Ready-made prompts

Fill in the parts in angle brackets, then paste into any assistant.

Step by step on your store

Read https://help.pasilobus.com/image-gallery/lightbox-and-captions.md. Walk me through lightbox and captions in Image Gallery for my store, step by step. My theme is <theme name> and I want <what you want to happen>.

Ask your own question

Read https://help.pasilobus.com/image-gallery/lightbox-and-captions.md. Answer this about Image Gallery on my store: <your question>.

Ask Shopify Sidekick

In your Shopify admin, ask Sidekick about Image Gallery. It searches these guides.

Our MCP server lets Claude, ChatGPT, OpenClaw and other MCP clients use your Pasilobus apps. It is in beta and open to every Pasilobus account: you sign in with it when your assistant asks. Tools that change your store are marked as changes, so your assistant asks you first.

https://cloud.pasilobus.com/mcp

In Claude Code, add it, then run /mcp to sign in:

claude mcp add --transport http pasilobus https://cloud.pasilobus.com/mcp

In Claude on the web or desktop, go to Customize › Connectors › Add custom connector and paste the address. In ChatGPT, OpenClaw or another client, add it as a custom connector (MCP) with the same address.

npm install -g pasilobus

Run your apps from the terminal or a coding agent. These only read, so they are safe to try:

pasilobus image-gallery engagement

Gallery views, image opens and hotspot clicks over recent days

pasilobus image-gallery galleries

Gallery and image totals, and each gallery's layout

pasilobus apps lists your apps on the store; pasilobus <app> help lists what each app can do. How it works

On this page
  1. Turning the Lightbox On or Off
  2. Lightbox Background
  3. Navigating the Lightbox
  4. Image Captions
  5. Where Captions Come From

The lightbox lets visitors click any image in your gallery to view it full-size on a dimmed overlay, then page through the rest of the gallery with previous and next arrows. Captions display each image's title and description, either on hover or below the image, depending on what fits your design.

Turning the Lightbox On or Off

The lightbox is configured in the block's settings inside the theme editor, not in the app:

  • Open the theme editor - Go to Online Store › Themes › Customize and find the page with the Image Gallery block.
  • Click the block - The block settings panel opens on the right.
  • Toggle Enable lightbox on click - On by default. Turn off if you want clicks on images to do nothing (for example, if you're showing the gallery as decorative content).
  • Save - The change is live on your storefront immediately.

When the lightbox is on, you can choose how the overlay looks:

  • Dark - A near-black overlay (~92% opacity). The default, and the right choice for most stores — it makes images pop and feels cinematic.
  • Light - A near-white overlay (~95% opacity). Use this if your store has a light, airy aesthetic and dark overlays feel too heavy.

Visitors can move through your gallery without closing the lightbox:

  • Previous and next arrows - On screen at the left and right edges.
  • Keyboard arrows - Left and right arrow keys cycle through images.
  • Escape key - Closes the lightbox.
  • Click outside the image - Also closes the lightbox.

Image Captions

The block has two caption settings — Image titles and Image descriptions — and each offers the same three choices, so you can show one, both, or neither:

  • Hidden - No caption appears. The cleanest look — good when images speak for themselves.
  • Show on hover - The text appears as an overlay when the visitor hovers (desktop) or after a tap (mobile). Keeps the gallery uncluttered but lets curious visitors see context.
  • Show below image - The text sits as a small caption underneath each image. Always visible — good for lookbooks where you want to credit products, models, or locations.

Descriptions render smaller and slightly subdued next to the title, so a title plus a description reads as a heading and a line of detail rather than two competing captions.

Where Captions Come From

Captions come from the Title and Description fields on each image. To edit them:

  • Open the gallery in the app.
  • Hover the image you want to update and click the edit icon in its top-right corner.
  • Edit the Title - Shown wherever Image titles is set to hover or below.
  • Edit the Description - Shown wherever Image descriptions is set to hover or below.
  • Edit Alt text - Separate from the caption. Alt text is for accessibility and SEO and is read by screen readers and search engines.
  • Click Save in the editor - The tile updates on the spot, and the change applies to every gallery using that image.

If an image has no title, no title caption is shown for that image even when captions are enabled — the same goes for descriptions.

Talk to a person.

The people who build our apps answer support themselves. Send us a message or email us, and a person replies, usually within one business day. There's no chat.