# Gallery images

![image](https://docs-assets.foxecom.app/zest-theme/Fox-BG%20Light%20(37)_GO9iEIzs.jpg)

Inspire your customers by showcasing compelling images like a gallery, giving them a better understanding of the items, and browsing your products more easily.

<Hint type="info">

This section is available on ✨ **Zest version 7.0.0 onwards**. See our [Changelog](/zest-theme/changelog)

</Hint>

## How to add a Gallery images section to your Shopify store

<Hint type="success">

**Steps**

1. In the theme editor **(Customize)**, click **Add section.**
2. Locate **Gallery images**.
3. Make necessary changes.
4. **Save.**

</Hint>

## How to edit the Gallery images section

### Section settings

These control how the entire gallery behaves and looks.

<Table widths="220,auto">

| Setting | Description |
| --- | --- |
| **Heading** | Add a title for the section.<br/>[Highlight text](https://docs.foxecom.com/zest-theme/pages-global-sections/general-settings#highlight-text) |
| **Subheading** | Optional short text shown above the heading — ideal for labels like “Tag us” or “As seen on” |
| **Description** | Add a short message. |
| **Button label &#x26; link** | Add a CTA button (e.g., “Follow us”) and link it to your social page or campaign. Leave blank to hide the button. |
| **Button style** | Choose the button style to match your brand look. |
| **Image ratio** | Controls how images are cropped: choose **Adapt to image** (keep original ratio) or a fixed shape. |
| **Images per row** | Set how many images show per row on desktop (2 to 12). |
| **Column gap** | Adjust spacing between the images (when the **Layout** is **Grid**). |
| **Layout** | Choose between:<br/>• **Grid** layout:<img src="https://docs-assets.foxecom.app/zest-theme/image_ZRCEAOEI.png" alt="image" /><br/>• **Metro** layout:<img src="https://docs-assets.foxecom.app/zest-theme/image_U9bqoS2P.png" alt="image" /> |
| **Color scheme** | Pick a background/text color preset that matches your theme. |
| **Enable carousel on desktop** | Optional — turns the grid into a swipeable carousel if there are more images than columns.<img src="https://docs-assets.foxecom.app/zest-theme/image_UHrY3T4f.png" alt="image" /> |
| **Show navigation / pagination** | Toggle arrows or page dots for the carousel view. |
| **Enable swipe on mobile** | Allow users to swipe through images horizontally on mobile.<img src="https://docs-assets.foxecom.app/zest-theme/image_DYn4FgB6.png" alt="image" /> |
| **Number of columns on mobile** | Choose 1 or 2 columns layout for smaller screens. |

</Table>

### Block settings

Each **Image block** lets you upload an individual image to the gallery.

<Table widths="220,auto">

| Setting | Description |
| --- | --- |
| **Image** | Upload your image. JPG or WEBP formats work best. |
| **Text (optional)** | Add short label text on the image when hovering. |
| **Text size** | Choose between Small, Medium, or Large to adjust text visibility. |
| **Link** | Link the image to a product, collection, or social post. Leave blank if you don’t want it clickable. |

</Table>