# Image cards: Flex carousel

<figure><img src="/files/Q8QSvYKCPDVLnN7M3MDK" alt=""><figcaption></figcaption></figure>

Showcase products, collections, or image-based storytelling using a flexible, swipe-ready carousel layout.

## How to add an Image cards: Flex carousel section to your Shopify store

{% hint style="success" %}

1. In the theme editor **(Customize)**, click **Add section.**
2. Select **Image cards: Flex carousel** section.
3. Make necessary changes.
4. **Save.**
   {% endhint %}

## How to edit the section Image cards: Flex carousel

### Section settings

#### **Carousel settings**

<table><thead><tr><th width="275">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Overflow content</strong></td><td>Control whether items slightly peek outside the container (<code>visible</code>) or use edge shadows (<code>edge-shadows</code>).</td></tr><tr><td><strong>Slides per view</strong></td><td>Choose <code>auto</code> (free-size cards) or fixed <code>columns</code>.</td></tr><tr><td><strong>Columns</strong></td><td>Number of desktop columns (2–4). Visible only if using fixed columns.</td></tr><tr><td><strong>Column gap</strong></td><td>Horizontal space between cards on desktop.</td></tr></tbody></table>

{% tabs %}
{% tab title="Visible" %}

<figure><img src="/files/ajuEHZqhcBo08V5Xt4Zi" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Edge shadows" %}

<figure><img src="/files/CMF3ISp4qmVo9yZFDBCh" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### **Carousel controls**

<table><thead><tr><th width="275">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Control type</strong></td><td>Choose navigation style: none, standard arrows, or floating arrows.</td></tr></tbody></table>

{% tabs %}
{% tab title="Standard" %}

<figure><img src="/files/Vmiwt7TgeqihmyaXPvt0" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Float" %}

<figure><img src="/files/3A3HK7q31TCMybubpnYC" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Block settings

Beside the static **Header** block. The carousel supports 3 block types:

* [Image card](/pebble-theme/theme-blocks/basic.md#image-card)
* [Collection card](/pebble-theme/theme-blocks/collection.md#collection-card)
* Collection item (custom card)

<details>

<summary>See Collection item block settings</summary>

Display a compact, clickable collection pill with an image and title.

<figure><img src="/files/kbUkiYm4bU47FW8mbrtY" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="275">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Collection</strong></td><td>Select a collection to link to. If set, the entire block becomes a clickable link.</td></tr><tr><td><strong>Image</strong></td><td>Upload a custom image. If left blank, Pebble auto-pulls: collection image → first product image.</td></tr><tr><td><strong>Aspect ratio</strong></td><td>Controls image shape.</td></tr><tr><td><strong>Collection title</strong></td><td>Optional custom title. If blank, the collection’s real name is used.</td></tr></tbody></table>

</details>


---

# 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/pebble-theme/theme-sections/image-cards-flex-carousel.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.