# Slideshow

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**.* |

### 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**.* |


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.