# Slideshow

The **Slideshow** displays up to 8 auto-rotating slides to showcase your product images. You can fine-tune how your images look, all slide headings and colors, and add a mobile-specific image for the best experience across all devices.

> **Tip** | See the [Slideshow split](https://help.fluorescent.co/lorenza/sections/theme-sections/slideshow-split) section to show two images or autoplay videos in a single slide.

![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-cf96482da425bd454e5c5f0751fac42450be75e0%2Fslideshow-full-height.jpeg?alt=media)

## Set up section

Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.

{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](https://help.fluorescent.co/lorenza/general/editing-themes/using-templates#create-and-assign-multiple-templates) or [use metafields and dynamic sources](https://help.fluorescent.co/lorenza/general/adapting-your-theme/dynamic-content-with-metafields).
{% endhint %}

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Select a **Template** to edit from the dropdown menu in the top bar.

   > Learn how to use templates in our [Templates guide](https://help.fluorescent.co/lorenza/general/editing-themes/using-templates).
2. Under **Template**, click **(+) Add section** and select **Slideshow**.
3. Click and hold the drag-and-drop handles **`⋮⋮`** to re-order your sections.

</details>

### Add image slides

Add up to 8 slides with unique images, headings, buttons, and custom colors.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click **(+) Add slide** and/or click on the **Slide block** to open the settings.

   ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-1eabc856d9d0a6b6b75a60d28d9f9343c0fcaf48%2Fslide-image-settings.jpeg?alt=media)
2. Under **Image**, click **Select image** to upload and select your image file.

   > There are no required images dimensions. We recommend images that are **square (1:1)** or **landscape (3:2)** (wider than tall) with a minimum width of **`2050px`** for optimal quality across all devices.
3. (*Optional*.) Under **Mobile image**, click **Select image** to upload and select an alternate slide image that will show only on mobile.

   > You may want a different image that works best with mobile screen dimensions.
4. Select the **Image focal point** to choose which section of the image to keep centered within the slide.

   > This setting ensures the key part of your image appears when cropping occurs.

   > To turn off cropping, you can set the Slideshow image height to **Original**.
5. (*Optional*.) Click and hold the drag handles **`⋮⋮`** to rearrange the blocks:

   ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-22765d66f3708b95b5907a71e6b24326594ad146%2Fshopify-content-drag-handles.jpeg?alt=media)

   > Click **Remove block** in the block settings to delete a block.

   > Click the **Eye icon** to hide or unhide a block.
6. Click **Save**.

</details>

### Add slide headings

Add headings for your slides and change the text size and position.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click the **Slide** block to open the settings.

   ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-8796e0c94248f6bba93b43e73fc9bfdacfc28f35%2Fslide-content-settings.jpeg?alt=media)
2. Add a **Heading** as a title of slide.

   > We recommended a short title of just a few words.
3. (*Optional.*) Add a **Small heading** to display above the Heading.

   > We recommended using the small heading as a label or category for what you're showcasing in the slide, such as "Products", "Collections", or "Blog posts", etc.

   ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-3a1d57b04421bfc353a459562f24725b3e8ef04c%2Fmini-heading.jpeg?alt=media)
4. Add **Subheading** text to display below the heading.

   > We recommend two or three short sentences.
5. (*Optional*) Use the sliders to adjust the **Heading size** and **Subheading size**.
6. Use the **Max width of text** slider to control the maximum width of the headings.

   > Use this setting to create a clean visual shape for your text and avoid unwanted line breaks.
7. Select a **Text container color** to display your slide content in a solid box container. By default, the color is set to transparent.

   ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-abef47884c2c287213b742b646e2ab36a55aa125%2Fslide-container.jpeg?alt=media)
8. Change the **Text color** to make sure the headings are readable against the other colors or your slide image.
9. Change the position of the slide content by selecting the **Text alignment**.
10. (*Optional*.) Select an **Overlay color** to display overtop of the image and adjust the **Overlay opacity** using the slider.

    ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-0c7a25196fdc88364c9912d2deb6813e925568b4%2Fslide-opacity.jpeg?alt=media)

    > The **Overlay** lets you control the brightness and tone of images. Use this setting to balance it with other images and to increase contrast with headings so they're readable.

    > Set the opacity to *0%* to turn off the overlay color; set it to *100%* to create a solid color block with no image.
11. (*Optional*.) Click the **Overlay gradient** option to add a color overlay that fades across a range of hues.

    > You can choose the style, angle, position, and opacity of the gradient. See Shopify's [color gradient guide](https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients) to learn more.
12. Click **Save**.

</details>

### Add buttons

Link to your collections or products or any other page with a call-to-action button. Add **Button text** to display a button or leave this field blank to make the entire block a clickable link.

<figure><img src="https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2FPoVFtIRoE6KNRh1bydov%2Fimage.png?alt=media&#x26;token=e4b76796-72ec-4a9c-b2fd-debfa248bb28" alt="" width="280"><figcaption></figcaption></figure>

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click on the **Slide block** you wish to edit.
2. Select or paste a **Link**.

   > Make sure you copy the full URL, including **`https://`** at the start. For example: **`https://instagram.com/abc123`**.
3. Add **Button text** to display a button underneath the headings. Leave the **Button text** blank to make the entire block a clickable link.

   > The entire slide will become a link if no **Button text** is added.

   > The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now). To learn more, read ["What is a Call to Action?"](https://www.thebalancesmb.com/call-to-action-1794380).
4. Change the colors for the **Button text** and **Button background** to match your branding and slide content.
5. Click **Save**.

</details>

## Section style

### Slideshow height (image cropping)

The **Slideshow** section can display your slides at a **Custom height** or show your uploaded images with their **Original height** without cropping.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click on the **Slideshow** section to open the settings.

   ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-1470a7bba9e70c6c53496698aef6fbf17df9993e%2Fslideshow-settings.jpeg?alt=media)
2. Choose to display slides images with a **Custom** or their **Original** height (without cropping).

   > The **Custom** setting will make all slides uniform in height.

   > For the **Original** setting, we recommend uploading images with the same dimensions to avoid irregularity in the slideshow height when rotating.
3. If **Custom** height is selected: adjust the **Height** and **Mobile Height** of your slide images between 50% to 100% of the maximum height.

   > When **Custom height** is set to 50%, the slideshow will always display at half the height of the customer's screen or window height.
4. Click **Save**.

</details>

### Time between slides

By default, multiple slides will rotate every **5** seconds. You can choose to display each slide between **5** to **15** seconds.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1. Click on the **Slideshow** section to open the section settings.

   ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-73cf05fa8967c30aa75e324db0292d2b9afc34e8%2Fslideshow-time.jpeg?alt=media)
2. Move the slider to set the **time between slides** between **`3`** to **`15`** seconds.
3. Click **Save**.

</details>

## Settings reference

Click on the section to find the following settings:

| Setting             | Description                                                                                                                                                                                                                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Image Height        | Set the image height to Custom or Original. Select Original to display your uploaded image without cropping.                                                                                                                                                                                            |
| Custom height       | The height of the mobile slideshow as a percentage of the screen height. Your image will be cropped to match the height. If the custom height is 100%, the slideshow will expand the full height of any screen.                                                                                         |
| Time between slides | The number of seconds each slide is shown before rotating. Choose between 5 seconds and 15 seconds.                                                                                                                                                                                                     |
| Subheading text     | Enter subheading text to display below the heading. Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's [Rich text editor manual](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor). |
| Max width of text   | Use the slider to control the maximum width and line breaks of the headings.                                                                                                                                                                                                                            |
| Link                | Choose a page from your store to be link to from the section's call to action button.                                                                                                                                                                                                                   |
| Link text           | Add text to be used on the call to action button.                                                                                                                                                                                                                                                       |
| Text alignment      | Select the position of the headings using the dropdown.                                                                                                                                                                                                                                                 |

Click on the **Slide blocks** to find the following settings:

| Setting                  | Description                                                                                                                                                                                                                                                                                           |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Image                    | There are no required images dimensions. We recommend images that are square (1:1) or landscape (3:2) (wider than tall) with a minimum width of 2050px for optimal quality across all devices.                                                                                                        |
| Mobile image             | Add alternate image to displayed only on mobile devices                                                                                                                                                                                                                                               |
| Image focal point        | <p>Select the Media focal point to control what part of the image to center within the slide.<br><br>Use the focal point to make sure the key part of your image or video won't be cropped when it overflows the size of the block.</p>                                                               |
| Mobile image focal point | Select the Media focal point to control what part of the image to center within the slide.                                                                                                                                                                                                            |
| Small heading            | Add mini heading text in all capitals above the heading. We recommended a one or two word label.                                                                                                                                                                                                      |
| Heading                  | Add heading text to display as the slide title.                                                                                                                                                                                                                                                       |
| Subheading               | Add subheading text to display below the heading. Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's [Rich text editor manual](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor). |
| Heading font size        | Use the slider to change the font size of the heading.                                                                                                                                                                                                                                                |
| Subheading font size     | Use the slider to change the font size of the subheading.                                                                                                                                                                                                                                             |
| Max width of heading     | Use the slider to control the maximum width and line breaks of the heading.                                                                                                                                                                                                                           |
| Max width of subheading  | Use the slider to control the maximum width and line breaks of the subheading.                                                                                                                                                                                                                        |
| Link                     | Select or paste a link for the button or slide.                                                                                                                                                                                                                                                       |
| Button text              | Add custom text for your call-to-action button.                                                                                                                                                                                                                                                       |
| Text alignment           | Position the Heading, Subheading, and Button to one of nine quadrants of the block.                                                                                                                                                                                                                   |
| Color                    | Select the text, button, background, and overlay color of the block.                                                                                                                                                                                                                                  |
| Overlay opacity          | Use the slider to adjust the transparency of the overlay color.                                                                                                                                                                                                                                       |
| Text container color     | Choose a color to display your slide content in a solid color box.                                                                                                                                                                                                                                    |
| Text color               | Choose the color of the slide text.                                                                                                                                                                                                                                                                   |
| Button text color        | Select the color of the button label (e.g. "Shop now")                                                                                                                                                                                                                                                |
| Button background color  | Select the color of the entire button background.                                                                                                                                                                                                                                                     |

\\

***

> **Related links**
>
> [Image hero](https://help.fluorescent.co/lorenza/sections/theme-sections/image-hero)\
> [Gallery](https://help.fluorescent.co/lorenza/sections/theme-sections/gallery)\
> [Slideshow split](https://help.fluorescent.co/lorenza/sections/theme-sections/slideshow-split)
