# Icon boxes ![](https://docs-assets.foxecom.app/pebble-theme/0070b2eb-563a-424f-b331-6abcd5c30677.png) The **Icon boxes** section displays a collection of icon cards in a customizable grid or carousel layout. Each card can include an icon or image, heading, supporting text, and an optional link. Use this section to highlight product benefits, services, brand values, key features, or other important information in an easy-to-scan format. You can control the number of columns, spacing between cards, and mobile layout. Each Icon box can also have its own content, text alignment, color scheme, and corner radius. ## How to customize the Icon boxes section 1. In the theme editor (**Edit theme**), open the page where you want to display the section. 2. Click **Add section** and select **Icon boxes**. 3. Choose **Grid** or **Carousel** and configure the number of columns and spacing. 4. Adjust the mobile layout, color scheme, and padding if needed. 5. Open **Header** to customize the section heading and alignment. 6. Add, remove, or reorder **Icon box** blocks. 7. Customize each Icon box's icon, heading, text, link, and appearance. 8. Open **Quick view** to customize its heading and button if needed. 9. Click **Save**. ## Section settings ### Layout Controls how Icon boxes are arranged on desktop and larger screens. | Setting | Description | Options | | -------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **Type** | Controls how the Icon boxes are displayed. | **Grid**: Displays Icon boxes in rows and columns.

**Carousel**: Displays Icon boxes in a horizontally navigable carousel. | | **Columns** | Sets the number of Icon boxes displayed across each row. | **2–6 columns.** | | **Column gap** | Controls the horizontal space between Icon boxes. | **0–100px.** | | **Row gap** | Controls the vertical space between rows of Icon boxes. | **0–100px.**

*Available when **Type** is set to **Grid**.* |
![image](https://docs-assets.foxecom.app/pebble-theme/image_h60p39XI.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_6o7OGrBc.png) ### Mobile layout Controls how Icon boxes are arranged and spaced on mobile devices. | Setting | Description | Options | | -------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | | **Enable swipe on mobile** | Allows customers to swipe horizontally through Icon boxes on mobile devices. | **On** or **Off.** | | **Custom column width** | Allows you to set a custom width for each Icon box in the mobile swipe layout. | **On** or **Off.**

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

*Available when **Custom column width** is turned **on**.* | | **Mobile columns** | Sets the number of Icon boxes displayed per row on mobile. | **1 column or 2 columns.**

*Available when **Enable swipe on mobile** is turned **off** or **Custom column width** is turned **off**.* | | **Horizontal gap** | Controls the horizontal space between Icon boxes on mobile. | **0–100px.** | | **Vertical gap** | Controls the vertical space between rows of Icon boxes on mobile. | **0–100px.**

*Available when **Enable swipe on mobile** is turned **off**.* |
Turn on **Enable swipe on mobile** and **Custom column width**, then set **Custom width** below 90% to show part of the next Icon box and encourage customers to swipe. ### Appearance Controls the color scheme of the Icon boxes section. | Setting | Description | Options | | ---------------- | -------------------------------------------- | --------------------------------- | | **Color scheme** | Applies a theme color scheme to the section. | Select an available color scheme. |
### Padding Controls the spacing above and below the section content 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.** |
### Advanced The **Advanced** settings include **Custom columns**, which lets you define the number of columns at specific screen breakpoints. For detailed configuration and syntax, see the [**Custom columns** **documentation**](https://docs.foxecom.com/pebble-theme/global-settings/custom-columns). ## Blocks The **Icon boxes** section contains two built-in static blocks, **Header** and **Quick view**, along with repeatable **Icon box** blocks. * **Header** — Controls the section's introductory content and alignment. * **Icon box** — Displays an icon or image, heading, supporting text, and optional link. You can add, remove, or reorder these blocks. * **Quick view** — Displays a heading and call-to-action button below the Icon boxes. The **Header** and **Quick view** blocks cannot be removed or reordered, but you can customize their content and settings. The built-in **Icon box** inside the Icon boxes section is different from the standalone **Icon box** available under Theme blocks.
The standalone theme block includes additional layout, spacing, style, and border settings and is documented separately in the [**Icon box documentation**](https://docs.foxecom.com/pebble-theme/theme-blocks/icon-box).
### Header The **Header** block controls the section's introductory content and its alignment. ![](https://docs-assets.foxecom.app/pebble-theme/c8844a69-1015-47bb-9f40-b4bf10570344.png) It cannot be removed or reordered, but you can customize its layout and padding. 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. * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button) — Adds a call-to-action button. * [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image) — Displays an image within the Header. #### **Header - Layout** | Setting | Description | Options | | ------------- | -------------------------------------------------------- | ----------------------------------- | | **Alignment** | Controls the horizontal alignment of the Header content. | **Left**, **Center**, or **Right**. |
#### **Header - Padding** | Setting | Description | Options | | ----------- | ----------------------------------------------------------------- | -------------------------- | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile.** | | **Bottom** | Controls the space between the Header content and the Icon boxes. | **0–100px.** |
### Icon box Each **Icon box** displays an icon or image alongside a heading and supporting text. You can also add a link to make the Icon box lead to another page. ![](https://docs-assets.foxecom.app/pebble-theme/bc9fd008-cfc3-48c0-9814-d9dbd25f5b9b.png) You can add, remove, or reorder Icon box blocks. Each block has its own content, alignment, and appearance settings. #### Icon box – Layout Controls the alignment of the content within the Icon box. | Setting | Description | Options | | ------------------ | ---------------------------------------------------------- | ------------------------------- | | **Text alignment** | Controls the horizontal alignment of the Icon box content. | **Left, Center,** or **Right.** |
#### Icon box – Icon Controls the icon or image displayed in the Icon box. | Setting | Description | Options | | ---------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Icon** | Selects a built-in icon to display in the Icon box. | Select an available icon. | | **Image icon** | Replaces the built-in icon with an image. | Select an image from the Shopify file library or upload a new one.

*When added, the **Image icon** takes priority over the built-in **Icon**.* | | **Icon size** | Controls the size of the icon. | **Extra small, Small, Medium, Large, Extra large,** or **Custom** | | **Width** | Sets the custom icon width on larger screens. | **12–200px**.

*Available when **Icon size** is set to **Custom**.* | | **Width mobile** | Sets the custom icon width on mobile devices. | **12–200px**.

*Available when **Icon size** is set to **Custom**.* |
Use a consistent icon size across all Icon boxes to create a balanced layout. Select **Custom** when you need different icon sizes for desktop and mobile. #### Icon box – Content Controls the heading, supporting text, and destination link of the Icon box. | Setting | Description | Options | | ------------------ | ------------------------------------------------------------------------------ | --------------------------------------------------- | | **Link** | Makes the Icon box clickable and directs shoppers to the selected destination. | Select a page, product, collection, or enter a URL. | | **Heading** | Sets the main title displayed in the Icon box. | Enter custom text. | | **Heading preset** | Controls the heading's typography style. | **Heading 3–6** | | **Text** | Sets the supporting description below the heading. | Enter and format text using the rich text editor. |
#### Icon box – Appearance Controls the color scheme and corner radius of each Icon box. | Setting | Description | Options | | ------------------------ | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- | | **Inherit color scheme** | Uses the surrounding section's color scheme instead of a separate color scheme for the Icon box. | **On** or **Off**. | | **Color scheme** | Applies a separate theme color scheme to the Icon box. | Select an available color scheme.

*Available when **Inherit color scheme** is turned **off**.* | | **Corner radius** | Controls how rounded the Icon box corners appear. | **0–32px.**

*Available when **Inherit color scheme** is turned **off**.* |
Turn off **Inherit color scheme** to give individual Icon boxes their own color scheme and rounded corners. This is useful for creating distinct cards or highlighting specific benefits. ### Quick view The **Quick view** block displays a heading and call-to-action button below the Icon boxes. ![](https://docs-assets.foxecom.app/pebble-theme/acc5a2a8-a98b-4ab0-9baf-a49fc0c79c5f.png) It cannot be removed or reordered, but you can customize its content, button appearance, spacing, and animation #### Quick view – Content | Setting | Description | Options | | ----------- | --------------------------------------------------- | ------------------ | | **Heading** | Sets the heading displayed in the Quick view block. | Enter custom text. |
#### Quick view – Button | Setting | Description | Options | | ------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------- | | **Button label** | Sets the text displayed on the button. | Enter custom text. | | **Button style** | Controls the visual style of the button. | **Primary, Secondary, Outline,** or **Plain.** | | **Button size** | Controls the size of the button. | **Extra small, Small, Medium,** or **Large.** | | **Button icon** | Selects an icon to display within the button. | None or select an available icon. | | **Enable button full wide on mobile** | Makes the button span the available width on mobile devices. | **On** or **Off**. |
Enable button full wide on mobile - ON
Enable button full wide on mobile - OFF
#### Quick view – Padding | Setting | Description | Options | | ----------- | ------------------------------------------------------------- | -------------------------- | | **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile.** | | **Top** | Controls the space above the Quick view content. | **0–100px.** |
#### Quick view – Animation Controls the entrance animation applied to the Quick view block. | Setting | Description | Options | | -------------- | -------------------------------------------------------- | --------------------------------------------------------------------------- | | **Type** | Controls the entrance animation of the Quick view block. | **None, Fade in, Fade up, Slide in (left),** or **Slide in (right).** | | **Delay (ms)** | Delays the start of the entrance animation. | **0–2000ms.**

*Available when **Type** is not set to **None**.* |
These settings are available when animations are enabled in **Theme settings**. Learn more: [Animations](https://docs.foxecom.com/pebble-theme/theme-settings/animations). ## FAQs **Why are fewer Icon boxes shown per row than the number of Columns I selected?** The **Columns** setting defines the maximum number of Icon boxes displayed across a row. The section automatically adjusts the number of visible columns based on the available screen width. Narrower screens may show fewer columns to keep the cards readable. **Why are all Icon boxes the same height even when they contain different amounts of text?** Icon boxes in the same row or carousel may stretch to match the height of the tallest card. If one Icon box contains more text, the other cards can appear taller with extra empty space. Keep descriptions at similar lengths for a more balanced layout. **Why are the Icon boxes at the edges partially visible or faded?** In **Carousel** mode, the section may display parts of the previous and next cards to indicate that more content is available. The faded appearance helps draw attention to the active cards while encouraging customers to browse horizontally. **Can I use a grid on desktop and a swipeable carousel on mobile?** Yes. Set **Type** to **Grid** and turn on **Enable swipe on mobile**. The Icon boxes will appear in a grid on larger screens and become horizontally swipeable on mobile devices. You can also use **Custom column width** to show part of the next card. **Can I display different Icon boxes on desktop and mobile?** No. The section uses the same Icon box blocks and display order across devices. You can customize the mobile layout, spacing, and icon sizes separately, but you cannot assign different sets of Icon boxes to desktop and mobile.