# Products highlight ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(3\)_ucknaHcn.jpg) Put a few key products next to a banner image or video that shows them in use, so customers can see the look and shop it right away. ## How to customize the Products highlight 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 **Products highlight**. 4. Click **Change** next to **Products** and choose the products to highlight. 5. Click the **Banner** block. 6. Click **Select** next to **Image** to add the banner image. 7. Click the **Header** block to edit the heading content. 8. Click **Save**. To add a video to the banner, open the **Banner** block and choose a **Source** under **Video**. ## Section settings ### Products | Setting | Description | Options | | ------------ | ---------------------------------- | ----------------------------------------- | | **Products** | Selects the products to highlight. | Select up to 50 products from your store. |
### Layout | Setting | Description | Options | | -------------------------- | ---------------------------------------------------------- | ---------------------- | | **Desktop image position** | Sets which side of the product list the banner appears on. | **Left** or **Right**. |
### Product cards Controls the information shown on the product cards. | Setting | Description | Options | | ----------------------- | ------------------------------- | ------------------ | | **Show badges** | Shows the product badges. | **On** or **Off**. | | **Show product vendor** | Shows the vendor or brand name. | **On** or **Off**. | | **Show product type** | Shows the product type. | **On** or **Off**. |
### Appearance | 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. |
### 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 one **Banner** block. ### Header
![image](https://docs-assets.foxecom.app/pebble-theme/image_tgzmu8l9.png)
The **Header** block holds the heading content next to the banner. | 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**, **Heading**, **Text**, and **Button** 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. ### Banner
![image](https://docs-assets.foxecom.app/pebble-theme/image_YNCwliKu.png)
The **Banner** block shows the image or video next to the products. #### Banner - Image | Setting | Description | Options | | ----------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------- | | **Image** | Sets the banner image on desktop. | Select or upload an image, or click **Explore free images**. | | **Image mobile** | Sets a separate banner image for mobile. | Select or upload an image, or click **Explore free images**. | | **Aspect ratio** | Controls the image proportions on desktop. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9),** or **Landscape (4/3)**. | | **Aspect ratio mobile** | Controls the image proportions on mobile. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9),** or **Landscape (4/3)**. |
#### Banner - Video | Setting | Description | Options | | ------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------- | | **Source** | Sets where the video comes from. | **Uploaded** or **External URL**. | | **Video** | Sets the video file. | Upload or select a video.

*Available when **Source** is set to **Uploaded**.* | | **Video URL** | Sets the link to a YouTube or Vimeo video. | Enter a URL.

*Available when **Source** is set to **External URL**.* | | **Video autoplay** | Plays the video automatically. | **On** or **Off**.

*Videos are muted by default.* | | **Video looping** | Restarts the video when it ends. | **On** or **Off**. | | **Aspect ratio** | Controls the video proportions. | **Auto, Square (1/1), Portrait (4/5), Portrait (3/4), Landscape (16/9),** or **Landscape (4/3)**. |
#### Banner - Appearance | Setting | Description | Options | | ----------------- | -------------------------------------------- | ----------- | | **Corner radius** | Controls how rounded the banner corners are. | **0–32px**. |
The video plays inside the banner image area. For the best result, use both an image and a video, or an image on its own. If you add only a video, an image placeholder is shown in the banner. ![image](https://docs-assets.foxecom.app/pebble-theme/image_IlQQKwxS.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_n3WIivc2.png) The image container is always larger than the video. If the video is larger than the image, the image **Aspect ratio** setting doesn't apply and the image adjusts to fit the video. For example, with a **Portrait (4/5)** video and a **Landscape (16/9)** image, the image ratio changes to fit the video. Keep the image and video aspect ratios consistent to avoid this. ## Tips and best practices * Highlight 1–5 products. The section is designed to feature key items, not replace a full product grid, and fewer products keep the message clear. * Feature products that appear in the banner image or video. * Use high-quality images, and prefer the `.webp` format for better performance. * Turn on **Video looping** for smooth, continuous playback. * Keep video files small so the page loads fast.