Slideshow

Theme section

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 section to show two images or autoplay videos in a single slide.

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.

Editing a template changes all pages that use that template. To edit specific pages, you can create new templates or use metafields and dynamic sources.

STEPS

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.

2. Under Template, click (+) Add section and select Slideshow.

3. Click and hold the drag-and-drop handles ⋮⋮ to re-order your sections.

Add image slides

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

STEPS

In your theme editor (Customize):

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

   
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:

   

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

   Click the Eye icon to hide or unhide a block.

6. Click Save.

Add slide headings

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

STEPS

In your theme editor (Customize):

1. Click the Slide block to open the settings.

   
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.

   
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.

   
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.

    

    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 ↗ to learn more.

12. Click Save.

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.

STEPS

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?".

4. Change the colors for the Button text and Button background to match your branding and slide content.

5. Click Save.

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.

STEPS

In your theme editor (Customize):

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

   
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.

Time between slides

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

STEPS

In your theme editor (Customize):

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

   
2. Move the slider to set the time between slides between 3 to 15 seconds.

3. Click Save.

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 ↗.
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	Select the Media focal point to control what part of the image to center within the slide. 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.
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 ↗.
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 Gallery Slideshow split