> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/section/expanding-gallery.md).

# Expanding gallery

A row of image panels where one panel is open and the others are slim strips that expand when clicked.

The Expanding gallery section shows up to six image panels side by side. One panel is open and shows its text and button, while the others are collapsed into slim strips. When a shopper clicks a strip, it smoothly expands and the previous panel collapses. Use it to showcase collections, campaigns or categories in a compact, interactive way.

On mobile, the panels stack vertically: collapsed panels become short horizontal bars, and the open panel expands below to its full height.

### 1. How to add the section

In the theme editor, click **Add section** and choose **Expanding gallery** (in the **Banners** category). The section is added with four example panels.

### 2. Section settings

**Section header**

* **Header layout:** Heading above description, or Heading beside description (on larger screens).
* **Content alignment:** Left or Center.

**Gallery**

* **Desktop height:** Small, Medium, Large or Custom.
  * **Custom height:** appears when you choose Custom (200–1000 px).
* **Expanded panel size:** how much wider the open panel is than the collapsed strips (2–6).
* **Auto-rotate panels:** opens the next panel automatically. Rotation pauses while a shopper hovers over or focuses the gallery.
  * **Rotate every:** the time between panels (3–10 seconds).
* **Show labels on collapsed panels:** shows a label on each collapsed strip.
  * **Label style:** Panel heading or Number.

**Mobile layout**

* **Mobile height:** the height of the open panel on mobile. Options: Small, Medium, Large or Custom.
  * **Custom height:** appears when you choose Custom (200–800 px).

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md).
{% endhint %}

### 3. Block settings

Each **Gallery** block adds one panel. You can add up to 6. The first panel is open when the page loads.

* **Image:** the panel image.
* **Mobile image:** an optional separate image for mobile.
* **Overlay opacity:** adds a dark layer over the image so the text is easier to read (0–100%).
* **Subheading**, **Heading**, **Heading size** and **Description:** the text shown when the panel is open.
* **Button label** and **Button link:** an optional button in the open panel.
* **Content position:** where the text sits in the open panel. Options: Bottom left, Bottom right, Top left, Top right or Center.
* **Color:** turn on **Use custom colors** to set the **Heading** and **Text** colors for this panel.

{% hint style="info" %}
**Note:** When **Label style** is set to Panel heading, the strip label uses the block's **Heading**, so keep headings short.
{% endhint %}
