# Collection list: Flex carousel ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(11\)_g1EXx5Bx.jpg) Highlight your best-selling and seasonal collections with an easy-to-scroll carousel for faster shopping. ## How to customize a Collection list: Flex carousel section 1. Open the page where you want to display the section. 2. Click **Add section** and select **Collection list: Flex carousel**. 3. Configure the section layout, carousel settings, and appearance. 4. Add and customize collection blocks to display your desired collections. 5. Adjust the mobile layout and spacing for smaller screens. 6. Click **Save**. ## Section settings ### Layout | Setting | Description | Options | | ------------- | ----------------------------------------- | ---------------------- | | **Container** | Sets the width of the carousel container. | **Full** or **Fixed**. |
### Carousel settings | Setting | Description | Options | | -------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | **Overflow content** | Controls how collection cards extending beyond the visible carousel area appear. | **Visible** or **Edge shadows**. | | **Slides per view** | Determines how the number of visible collection cards is calculated. | **Auto** or **Columns**. | | **Columns** | Sets the number of collection cards visible at once. | 1 – 4 columns

*Available when Slides per view is set to **Columns**.* | | **Horizontal gap** | Adjusts the horizontal spacing between collection cards. | **1 – 100px** |
![image](https://docs-assets.foxecom.app/pebble-theme/image_MPUj29cV.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_xv0CaYlN.png) Choose **Auto** for flexible card widths, or select **Columns** to display a specific number of collection cards at once. ### Mobile layout | Setting | Description | Options | | -------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | **Enable swipe on mobile** | Allows customers to swipe horizontally through collection cards on mobile. | On or Off. | | **Custom column width** | Manually adjust the width of each collection card on mobile. | On or Off.

*Available when **Enable swipe on mobile** is turned on.* | | **Custom column width** | Sets the width of each collection card on mobile. | **20 – 90%**.

*Available when Custom column width is turned on.* | | **Columns** | Sets the number of collection cards displayed per row on mobile. | **1 column or 2 columns**.

*Available when Custom column width is turned off.* | | **Horizontal gap** | Adjusts the horizontal spacing between collection cards on mobile. | **0 – 100px.** |
![image](https://docs-assets.foxecom.app/pebble-theme/image_YtXza2hp.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_zHyq7Ssc.png) ### Appearance | Setting | Description | Options | | ------------------ | ----------------------------------------------------- | --------------------------------------------------------------------------- | | **Color scheme** | Applies a predefined color scheme to the section. | Available theme color schemes. | | **Border** | Controls whether a border appears around the section. | **None** or **Solid**. | | **Border width** | Adjusts the thickness of the section border. | **0 – 100px**.

*Available when **Border** is set to **Solid***. | | **Border opacity** | Controls the transparency of the section border. | **0 – 100%**

*Available when **Border** is set to **Solid***. | | **Corner radius** | Adjusts the roundness of the section's corners. | **0 – 32px** |
### Carousel settings | Setting | Description | Options | | ---------------- | ---------------------------------------------------------------------- | ------------------------------------- | | **Control type** | Determines the style and position of the carousel navigation controls. | **None**, **Standard**, or **Float**. |
![](https://docs-assets.foxecom.app/pebble-theme/0f8d9017-b6b7-4466-8657-af555cd3ffb3.png) ![](https://docs-assets.foxecom.app/pebble-theme/392ee75e-48ab-4e44-8d48-1132ee1b536e.png) ![](https://docs-assets.foxecom.app/pebble-theme/abe97b62-44a8-4ded-ba50-2bd7bab34265.png) ### Padding | Setting | Description | Options | | ----------- | ------------------------------------------------------ | -------------------------- | | **Devices** | Selects the device type for adjusting section padding. | **Desktop** or **Mobile**. | | **Top** | Adjusts the space above the section. | **0 – 100px**. | | **Bottom** | Adjusts the space below the section. | **0 – 100px**. |
## Blocks The **Collection list: Flex carousel** section consists of a **Header** block for titles and supporting content, and repeatable **Collection item** blocks to display product collections. ### Header ![image](https://docs-assets.foxecom.app/pebble-theme/image_RJm13WEc.png) The **Header** block controls the introductory content displayed above or beside the Collection list: Flex carousel. It cannot be removed or reordered, but you can customize its layout, padding, and content. You can add and arrange supported theme blocks inside the Header, including: * [**Heading/Subheading/Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text) — Adds a heading, supporting text, or descriptive text. * [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image) — Adds an image to the Header. * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button) — Adds a call-to-action button. ### Collection item Each **Collection item** block displays an individual product collection within the carousel, including a collection image and title. You can add, remove, or reorder **Collection item** blocks to customize which collections appear and their display order. #### Collection item - Content | Setting | Description | Options | | ------------------- | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Collection** | Selects the product collection to display. | Select a collection. | | **Image** | Uploads a custom image for the collection item. Leave blank to use the collection's image. | Select or upload an image. | | **Aspect ratio** | Sets the image's aspect ratio. | **Use global settings:** Uses the image ratio configured in Theme settings.

**Auto:** Uses the image's original proportions.

**Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9),** or **Landscape (4/3)**. | | **Title** | Sets a custom title for the collection item. Leave blank to use the collection's title. | Enter custom text or leave blank. | | **Text line limit** | Controls the maximum number of lines displayed for the collection title. | No limit, 1 line, 2 lines, 3 lines. |
Use the same aspect ratio for all collection cards when you want the row to look consistent. #### Collection item - Size | Setting | Description | Options | | ---------------- | --------------------------------------------------- | ------------ | | **Width** | Adjusts the width of the collection item on desktop | 150 – 500px. | | **Width mobile** | Adjusts the width of the collection item on mobile | 150 – 500px. |
#### Collection item - Appearance | Setting | Description | Options | | ------------------------ | ---------------------------------------------------------------------------- | ------------- | | **Inherit color scheme** | Uses the parent section's color scheme for the collection item. | On / Off. | | **Border** | Choose **None** to remove the border or **Solid** to display a solid border. | None / Solid. | | **Border width** | Adjusts the thickness of the border | 0 – 3px. | | **Border opacity** | Controls the transparency of the border | 0 – 100%. | | **Corner radius** | Adjusts the roundness of the collection item's corners | 0 – 20px. |
### Additional blocks Besides the built-in **Collection item** blocks, the **Collection list: Flex carousel** section supports additional theme blocks for more flexible content presentation. You can add and arrange the following blocks: * [**Image card**](https://docs.foxecom.com/pebble-theme/theme-blocks/image-card) — Displays an image-based card. * **Image card: Countdown-timer** — Displays an image card with a countdown timer. * [**Video card**](https://docs.foxecom.com/pebble-theme/theme-blocks/video-card) — Displays a video-based card. * [**Collection card**](https://docs.foxecom.com/pebble-theme/theme-blocks/collection-card) — Displays a product collection in a card layout. To add more blocks, click **Add block** in the section and select the block you want to display. #### ## FAQs **How do I add more collections to the carousel?** Click **Add block** in the Collection list: Flex carousel section and select **Collection item**. Choose the collection you want to display and repeat to add more collections. **Can I use a custom image instead of the collection's default image?** Yes. Open the corresponding **Collection item** block and upload an image under **Image**. Leave this field blank to use the collection's default image. **Why does my carousel have no navigation arrows?** Check **Control type** under **Carousel settings**. If it is set to **None**, navigation controls are hidden. You can select **Standard** or **Float** to display navigation controls. Their visibility may also depend on whether the carousel contains content that extends beyond the visible area. **Can I combine collection items with promotional images or videos in one carousel?** Yes. The section supports multiple block types, including **Collection item**, **Image card**, **Image card: Countdown-timer**, **Video card**, and **Collection card**.