# Gallery images

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FD610V8nJZqBcmXFLfuxB%2FFox-BG%20Light%20(37).jpg?alt=media&#x26;token=414649cc-99ef-4985-a77a-46ad337cdf34" alt=""><figcaption></figcaption></figure>

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 style="info" %}
This section is available on ✨ **Zest version 7.0.0 onwards**. See our [changelog](https://docs.foxecom.com/zest-theme/changelog "mention")
{% endhint %}

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

{% hint style="success" %}
**Steps**

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

## How to edit the Gallery images section

### Section settings

These control how the entire gallery behaves and looks.

<table><thead><tr><th width="220">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Heading</strong></td><td>Add a title for the section.<br><a data-mention href="../../pages-global-sections/general-settings#highlight-text">#highlight-text</a></td></tr><tr><td><strong>Subheading</strong></td><td>Optional short text shown above the heading — ideal for labels like “Tag us” or “As seen on”</td></tr><tr><td><strong>Description</strong></td><td>Add a short message.</td></tr><tr><td><strong>Button label &#x26; link</strong></td><td>Add a CTA button (e.g., “Follow us”) and link it to your social page or campaign. Leave blank to hide the button.</td></tr><tr><td><strong>Button style</strong></td><td>Choose the button style to match your brand look.</td></tr><tr><td><strong>Image ratio</strong></td><td>Controls how images are cropped: choose <strong>Adapt to image</strong> (keep original ratio) or a fixed shape.</td></tr><tr><td><strong>Images per row</strong></td><td>Set how many images show per row on desktop (2 to 12).</td></tr><tr><td><strong>Column gap</strong></td><td>Adjust spacing between the images (when the <strong>Layout</strong> is <strong>Grid</strong>).</td></tr><tr><td><strong>Layout</strong></td><td><p>Choose between:</p><ul><li><strong>Grid</strong> layout:</li></ul><div><figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2F1SEA8TmDtemlaozhaI6r%2Fimage.png?alt=media&#x26;token=82a8e91c-81bb-427a-966e-fcf8c4ab3448" alt=""><figcaption></figcaption></figure></div><ul><li><strong>Metro</strong> layout:</li></ul><div><figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FeG6rdZUw1DIx9bGk0H6Z%2Fimage.png?alt=media&#x26;token=749a80e8-a782-4f3e-8de1-6b9d382ee62f" alt=""><figcaption></figcaption></figure></div></td></tr><tr><td><strong>Color scheme</strong></td><td>Pick a background/text color preset that matches your theme.</td></tr><tr><td><strong>Enable carousel on desktop</strong></td><td><p>Optional — turns the grid into a swipeable carousel if there are more images than columns.</p><div><figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FH9XCficsGOHa5au9n9Db%2Fimage.png?alt=media&#x26;token=bea72c0a-bd06-493c-898b-4b157730714c" alt=""><figcaption></figcaption></figure></div></td></tr><tr><td><strong>Show navigation / pagination</strong></td><td>Toggle arrows or page dots for the carousel view.</td></tr><tr><td><strong>Enable swipe on mobile</strong></td><td><p>Allow users to swipe through images horizontally on mobile.</p><div><figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FAiZe8puFVfEPZTl6aqkG%2Fimage.png?alt=media&#x26;token=087b5ff3-1777-4dce-b760-93b78bd582ac" alt=""><figcaption></figcaption></figure></div></td></tr><tr><td><strong>Number of columns on mobile</strong></td><td>Choose 1 or 2 columns layout for smaller screens.</td></tr></tbody></table>

### Block settings

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

<table><thead><tr><th width="220">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Image</strong></td><td>Upload your image. JPG or WEBP formats work best.</td></tr><tr><td><strong>Text (optional)</strong></td><td>Add short label text on the image when hovering.</td></tr><tr><td><strong>Text size</strong></td><td>Choose between Small, Medium, or Large to adjust text visibility.</td></tr><tr><td><strong>Link</strong></td><td>Link the image to a product, collection, or social post. Leave blank if you don’t want it clickable.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxecom.com/zest-theme/theme-sections/gallery-images.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.