> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/section/slideshow-1.md).

# Slideshow

The Slideshow section provides a bold and visually striking layout by combining side-by-side cards of images and video.

Show image and video cards side by side, each with its own text, collection links and button. When you add more cards than fit in one view, customers can move between them with the arrow buttons (on mobile, cards show one at a time).

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FngGaNLD2pKDY3KTIfOcu%2FScreenshot%202025-09-18%20at%202.08.53%E2%80%AFPM.png?alt=media&amp;token=81c141bf-e9e0-401a-8cda-28b7e75ff019" alt=""><figcaption></figcaption></figure>

### 1. How to add the section

{% stepper %}
{% step %}
In the theme editor, click **Add section**.
{% endstep %}

{% step %}
Choose **Slideshow** (in the **Banners** category). It's added with two image cards.
{% endstep %}
{% endstepper %}

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2F6dpBMXqRLSNPDmrdJRCH%2FScreenshot%202025-10-01%20at%203.21.03%E2%80%AFPM.png?alt=media&amp;token=412fed5b-3322-40a5-b97d-cdb17a5db163" alt=""><figcaption></figcaption></figure>

### 2. Section settings

**General**

* **Layout:** how many cards show side by side on desktop: 1 column, 2 columns or 3 columns.
* **Desktop media height:** Adapt to first media height, Small, Medium, Large or Full screen. **Adapt to first media height** uses the proportions of the first card's image or video for all cards.
* **Media overlay opacity:** darkens the images and videos (0–100%) so the text is easier to read.
* **Overlay style:** Gradient from bottom, Gradient from top or Full media darken.

**Mobile layout**

* **Mobile media height:** Adapt to first media height, Small, Medium, Large or Full screen.

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md). The Small, Medium and Large heights are set in [Appearance](https://help.byinspiredlabs.com/theme-settings/appearance.md).
{% endhint %}

### 3. Block settings

You can add **Image** cards and one **Video** card.

**Image**

* **Image:** the card image for desktop.
* **Mobile image:** an optional image for mobile. If you leave it empty, the desktop image is used.

**Video**

* **Video:** a video uploaded to Shopify. It plays automatically, muted and on a loop, while the card is in view.

**Settings in both cards**

* **Text:**
  * **Heading** and **Heading size** (Small, Medium or Large).
  * **Description:** text under the heading.
  * **Desktop content position:** where the text sits on the card. Choose from 9 positions, from Top left to Bottom right.
* **Collection links > Collections:** pick up to 6 collections to show as links on the card.
* **Button:** **Show button**, **Button label**, **Button link** and **Button style** (Solid, Outline or Text).
* **Colors:** turn on **Use custom colors** to pick the text color and the button color. By default, the text is white.
* **Mobile layout > Mobile content alignment:** where the text sits on the card on mobile (9 positions).
