# Image cards: Flex carousel ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20-%202025-11-24T172608.541_Q8QSvYKC.jpg) Showcase products, collections, or brand stories in a carousel of image cards that customers can scroll or swipe through. Each card pairs an image with a heading, text, and a button. ## How to customize the Image cards: Flex carousel section 1. Open the page where you want to display the section in the theme editor by clicking **Edit theme**. 2. Click **Add section**. 3. Select **Image cards: Flex carousel**. 4. Click an **Image card** block. To add another card, click **Add block** under the section and select **Image card**. 5. Click **Select** next to **Image** to add the card image. 6. Edit the **Subheading**, **Heading**, **Text**, and **Button** blocks inside the card. 7. Repeat steps 4–6 for each card. 8. Click the **Header** block to edit the heading content. 9. Click **Save**. ## Section settings ### Layout | Setting | Description | Options | | ------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | | **Container** | Controls the width of the section content. | **Full:** Uses the available page width.

**Fixed:** Keeps the content within the theme's fixed container width. |
### Carousel settings Controls how the cards are shown and spaced in the carousel on desktop. | Setting | Description | Options | | -------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- | | **Overflow content** | Controls how cards outside the visible area are shown. | **Visible:** Cards slightly peek outside the container.

**Edge shadows:** Adds shadows at the edges of the carousel. | | **Slides per view** | Controls how many cards are visible at once. | **Auto:** Sizes each card to its content.

**Columns:** Shows a fixed number of cards per view. | | **Columns** | Sets the number of cards per view. | **2–4 columns**.

*Available when **Slides per view** is set to **Columns**.* | | **Horizontal gap** | Controls the horizontal spacing between cards. | **0–100px**. | | **Control type** | Sets the navigation shown for the carousel. | **None, Standard,** or **Float**. |
![image](https://docs-assets.foxecom.app/pebble-theme/image_ajuEHZqh.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_CMF3ISp4.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_Vmiwt7Tg.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_3A3HK7q3.png) ### Mobile layout Controls how the section appears on mobile devices. | Setting | Description | Options | | -------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | **Enable swipe on mobile** | Controls whether customers can swipe horizontally through cards on mobile. | **On** or **Off**. | | **Custom column width** | Lets you manually control the width of each card on mobile. | **On** or **Off**.

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

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

*Available when **Enable swipe on mobile** is turned on and **Custom column width** is turned off.* | | **Horizontal gap** | Controls the horizontal space between cards on mobile. | **0–100px**. |
### Appearance Controls the visual style of the section. | Setting | Description | Options | | ------------------ | ----------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------- | | **Color scheme** | Applies a theme color scheme to the section. Learn more in [Colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors). | Select an available color scheme. | | **Border** | Controls whether the section has an outline. | **None** or **Solid**. | | **Border width** | Controls the thickness of the section border. | **0–10px**.

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

*Available when **Border** is set to **Solid**.* | | **Corner radius** | Controls how rounded the section corners appear. | **0–32px**. |
### Padding Controls the top and bottom spacing separately for desktop and mobile. | Setting | Description | Options | | ----------- | ------------------------------------------------------------- | :------------------------- | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. | | **Top** | Controls the space above the section content. | **0–100px**. | | **Bottom** | Controls the space below the section content. | **0–100px**. |
## Blocks The section includes one **Header** block and multiple **Image card** blocks. ### Header The **Header** block holds the heading content above the carousel. | Setting | Description | Options | | ------------- | ------------------------------------------------------------- | ------------------------------- | | **Alignment** | Sets the alignment of the header content. | **Left, Center,** or **Right**. | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. | | **Bottom** | Controls the space below the header. | **0–100px**. |
The default **Header** includes **Subheading** and **Heading** blocks. To add more, click **Add block** inside the **Header** and select one of these blocks: * [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the main title of the section. * [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short line above or below the heading. * [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays additional descriptions or details. * [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image): Displays an image or icon. * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button. ### Image card Each [**Image card**](https://docs.foxecom.com/pebble-theme/theme-blocks/image-card) shows an image with a subheading, heading, text, and button. Its settings cover the image, mobile image, media overlay, link, content layout, appearance, label, and image preloading. The default **Image card** includes these blocks: * [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short line above the heading. * [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the card title. * [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short description. * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button. [*See the **Image card documentation** for all available settings*](https://docs.foxecom.com/pebble-theme/theme-blocks/image-card). ### Add more blocks To add more items to the carousel, click **Add block** under the section and select one of these blocks: * [**Image card**](https://docs.foxecom.com/pebble-theme/theme-blocks/image-card): Displays an image with text and a button. * **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 with supporting information. * [**Collection card**](https://docs.foxecom.com/pebble-theme/theme-blocks/collection-card): Displays a collection with its image and title. * **Collection item**: Displays a compact, clickable collection link with an image and title. See the settings below. #### Collection item | Setting | Description | Options | | -------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | | **Collection** | Selects the collection to link to. The whole block becomes a link. | Select a collection from your store. | | **Image** | Sets a custom image for the item. | Select or upload an image.

*Leave blank to use the collection image, then the first product image.* | | **Aspect ratio** | Controls the image proportions. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9),** or **Landscape (4/3)**. | | **Collection title** | Sets a custom title. | Enter your text.

*Leave blank to use the collection's title.* |