# Slideshow ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20-%202025-11-26T092433.701_XFoX8DTd.jpg) Show several hero slides at the top of your page, each with its own image or video and a message such as a promotion and a **Shop now** button. The slides can rotate automatically, so customers see all your key messages without scrolling. ## Presets The Slideshow section includes two presets: **Slideshow: Centered** and **Slideshow: Minimal**. Both use the same settings. ## How to customize the Slideshow 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 **Slideshow: Centered** or **Slideshow: Minimal**. 4. Click an **Image slide** block. To add another slide, click **Add block** under the section and select **Image slide** or **Video slide**. 5. Click **Select** next to **Image** to add the slide image. 6. Click the **Slide content** block inside the slide. 7. Edit the **Heading** and **Button** blocks inside **Slide content**. 8. Repeat steps 4–7 for each slide. 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. | | **Height** | Sets the height of the slides. | **Adapt to image, Small, Medium,** or **Large**. | | **Content position** | Places the slide content inside or outside the image. | **Inside** or **Outside**.

*Available when **Container** is set to **Full**.* | | **Enable header overlay** | Lets the header sit transparently over the slideshow. Applies only on desktop and when this section is at the top of the page. | **On** or **Off**.

*Available when **Container** is set to **Full**.* | | **Allow the next section to overlap** | Lets the next section overlap the bottom of the slideshow. | **On** or **Off**.

*Available when **Container** is set to **Full**.* |
![image](https://docs-assets.foxecom.app/pebble-theme/image_5KH3GnBX.png) ### Appearance | Setting | Description | Options | | ----------------- | ----------------------------------------------- | -------------------------------------------------------------------------- | | **Corner radius** | Controls how rounded the slideshow corners are. | **0–32px**.

*Available when **Container** is set to **Fixed**.* |
### Carousel settings | Setting | Description | Options | | ----------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **Auto-rotate content** | Moves to the next slide automatically. | **On** or **Off**. | | **Change slides every** | Sets how long each slide stays before the next one. | **2-10s seconds.**

*Available when **Auto-rotate content** is turned on.* | | **Control type** | Sets how customers move between slides. | **Default** or **Progress text**. | | **Control alignment** | Sets the alignment of the default controls. | **Left, Center,** or **Right**.

*Available when **Control type** is set to **Default**.* |
![image](https://docs-assets.foxecom.app/pebble-theme/image_nSd4XtG5.png) ![image](https://docs-assets.foxecom.app/pebble-theme/image_taJ53xT1.png) With **Progress text**, each slide shows its **Pagination label**. Set the label in each **Image slide** or **Video slide** block. ### Padding Controls the top and bottom spacing of the section. | Setting | Description | Options | | ---------- | --------------------------------------------- | :----------- | | **Top** | Controls the space above the section content. | **0–100px**. | | **Bottom** | Controls the space below the section content. | **0–100px**. |
## Blocks Each slide is an **Image slide** or a **Video slide** block. Each slide contains a **Slide content** block that holds the text and buttons shown on top of the media. ### Image slide | Setting | Description | Options | | --------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | **Image** | Sets the slide image on desktop. | Select or upload an image, or click **Explore free images**. | | **Image mobile** | Sets a separate slide image for mobile. | Select or upload an image, or click **Explore free images**. | | **Media overlay** | Adds a color overlay to make the content easier to read. | **On** or **Off**. | | **Overlay color** | Sets the color of the overlay. | Select a color.

*Available when **Media overlay** is turned on.* | | **Position** | Sets where the content sits on the slide. | **Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center,** or **Bottom right**. | | **Position mobile** | Sets where the content sits on the slide on mobile. | **Top, Middle,** or **Bottom**. | | **Color scheme** | Sets the color scheme of the slide. | Select an available color scheme. | | **Text** (Pagination label) | Sets the label shown for this slide when **Control type** is set to **Progress text**. | Enter your text, such as **Slide 1**. |
Place the content where the image has natural empty space, and add a mobile image so the slide doesn't crop awkwardly on small screens. ### Video slide The **Video slide** plays a video that loops automatically and stays muted. | Setting | Description | Options | | --------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | **Video** | Sets the slide video. | Select or upload a video. | | **Position** | Sets where the content sits on the slide. | **Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center,** or **Bottom right**. | | **Position mobile** | Sets where the content sits on the slide on mobile. | **Top, Middle,** or **Bottom**. | | **Color scheme** | Sets the color scheme of the slide. | Select an available color scheme. | | **Text** (Pagination label) | Sets the label shown for this slide when **Control type** is set to **Progress text**. | Enter your text. |
Use short videos of 8–12 seconds that loop well, so the slide loads fast and plays smoothly. ### Slide content The **Slide content** block holds the text and buttons shown on top of the slide, and controls their layout and style. #### Slide content - Layout and size | Setting | Description | Options | | -------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------- | | **Alignment** | Sets how the content is aligned. | **Left, Center,** or **Right**. | | **Alignment mobile** | Sets how the content is aligned on mobile. | **Left, Center,** or **Right**. | | **Row gap** | Sets the space between the content blocks. | **0–100px**. | | **Row gap mobile** | Sets the space between the content blocks on mobile. | **0–100px**. | | **Width** | Sets the width of the content box. | **Fit, Fill,** or **Custom**. | | **Custom width** | Sets the content width as a percentage. | **0–100%**.

*Available when **Width** is set to **Custom**.* |
#### Slide content - Appearance | Setting | Description | Options | | -------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | **Inherit color scheme** | Controls whether the content uses the slide's color scheme. | **On** or **Off**. | | **Color scheme** | Sets a separate color scheme for the content. | Select an available color scheme.

*Available when **Inherit color scheme** is turned off.* | | **Transparent background** | Removes the background of the content box. | **On** or **Off**. | | **Border** | Adds a border around the content box. | **None** or **Solid**. | | **Border width** | Controls the thickness of the border. | **0–10px**.

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

*Available when **Border** is set to **Solid**.* | | **Corner radius** | Controls how rounded the content box corners are. | **0–32px**. |
#### Slide content - Padding and animation | Setting | Description | Options | | -------------- | --------------------------------------------------------- | -------------------------------------------------------------------------- | | **Top** | Sets the space inside the top edge of the content box. | **0–100px**. | | **Bottom** | Sets the space inside the bottom edge of the content box. | **0–100px**. | | **Left** | Sets the space inside the left edge of the content box. | **0–100px**. | | **Right** | Sets the space inside the right edge of the content box. | **0–100px**. | | **Type** | Sets the entrance animation of the content. | **None, Fade in, Fade up, Slide in (left),** or **Slide in (right)**. | | **Delay (ms)** | Sets how long to wait before the animation starts. | **0–2000ms**.

*Available when **Type** is not set to **None**.* |
The default **Slide content** includes **Heading** and **Button** blocks. To add more, click **Add block** inside **Slide content** and select one of these blocks: * [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the main title of the slide. * [**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. * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button. * **Spacer**: Adds vertical space between the content blocks.