In This Article
This section was added in v1.5.0 on Oct 27, 2022. See our change log and theme update guide to learn more.
The Gallery carousel section displays a single-row carousel of images with captions. Customers can click or horizontally scroll through the gallery of images.

Set up section
Add this section to any template (except Checkout) and re-order its position. You can use this section multiple times on the same page with different content and settings.
Note: New sections will appear on all pages that use the same template. To add sections to specific pages only, learn how to create and assign multiple templates.

Steps
In your theme editor (Customize):
Select a Template to edit from the dropdown menu in the top bar.
In the side panel, click (+) Add section and select Gallery carousel.
Change the order of your sections by using the drag and drop handles
⋮⋮
Add gallery images
Add multiple gallery images with captions and re-order them in the carousel.
Steps
In your theme editor (Customize):
Click on a Image with caption block to open the settings.
Block settings Click Select image to upload and select a gallery image.
We recommend square (1:1) images for the best fit. There are no required dimensions.
Use Image focal points to specify the main focus of your images. The focal point of your image will remain centered and within frame when your site adapts to different screen sizes.
See our image guide to learn more about specifying a focal point for an image used within a section or for an uploaded image file when used anywhere on your site.
Enter Title text to display overlayed the gallery image.
Enter Caption text to display under the title.
Use the formatting buttons to add bold, italic, and linked text.
(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.
Click Save.
Gallery image style
Customize the shape of the collection images, and the position, style, and colors of the titles.
Steps
Click on the Gallery carousel and scroll down to the Image settings.
Gallery with portrait images To make all gallery images a uniform shape and size, select an Image aspect ratio to crop all images to Square, Landscape, or Portrait.
The default Natural setting will display the original orientation of each image.
Example of aspect ratio shapes: Square, Landscape, and Portrait Set the Image caption style to Overlay the image or position it Beneath the image.
Captions beneath Select an Image caption size: either Small, Regular, or Large.
(If Overlay title style selected) Set the Background style to a Solid color or a Gradient.
Use the color selectors to change the Overlay title background and Overlay title color.
We recommend using WebAIM's contrast checker when matching colors to make sure your text is clear and readable for everyone.
Click Save.
Section headings and button
Add section headings and an optional button that can link to any page.
Steps
Click on the Gallery carousel section to open the section settings.
Enter Heading text to display a section title in the top-left.
The default heading is "Gallery carousel."
Enter Subheading text to display below the heading.
Use the formatting buttons to add bold, italic, or linked text.
Select or paste a URL for the Button Link.
Change the Button label (e.g. "View more").
Leave this field blank to remove the button.
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?"
Click Save.
Section layout and style
Adjust the overall style by changing the Padding around the section content, and add an optional Top divider to clearly separate sections.
Steps
Click on the Gallery carousel section and scroll down to find the section Layout and Style settings.
Section style settings Select the Number of columns to display for both desktop and mobile.
The size of the product images will change according to the number of columns.
Choose whether to Loop carousel when customers scroll or click-through the images.
This option is enabled by default.
Choose to Enable animation to show visual effects when scrolling, hovering, or interacting with the section.
Learn more about Section animations in Stiletto.
Choose to display a Top divider that separates sections with a Solid line.
The Top divider uses the color of Lines and borders set in the Theme settings.
Select a Padding option to change the spacing between sections. Choose between Top and bottom, Top only, Bottom only, or set it to None.
Click Save.
Gallery image block settings
Click on a Gallery image block to find the following settings:
Configuration Settings
Image
Upload and select an image for the gallery block.
Image focal point
Select the area of the image that will always appear centered within the slide to avoid cropping.
Title
Enter text to display a gallery image title overlayed or below the image.
Caption
Enter text to display below the title.
Section settings
Click on the Gallery carousel section to find the following settings:
Configuration Settings
Heading
Enter text for the section title in the top-left.
Subheading
Enter subheading text to display below the section heading.
Button link
Select or paste a URL for the button.
Button label
Enter text to display a button label.
Leave this field blank to remove the button.
Image aspect ratio
Crop the shape of your gallery images to Square, Landscape, or Portrait.
Choose Natural to display the original image shape.
Image caption style
Choose to Overlay the caption over the image or display the title Beneath the image.
Image caption size
Set the caption text size to Small, Regular, or Large.
Choose to Overlay the caption over the image or display the title Beneath the image.
Overlay text background style
Select the color behind the heading and caption to Solid or Gradient when set to the Overlay style.
Overlay text
Select the color of the title and caption when set to the Overlay style.
Overlay text background
Select the color behind the text when set to the Overlay style.
Number of columns on desktop
Choose the number of images to show in each row for desktop.
Number of columns on mobile
Choose the number of images to show in each row for mobile.
Section style settings
Click on the Gallery carousel section to find the following section settings:
Configuration Settings
Enable animation
Choose whether to Enable animation to show visual effects when scrolling, hovering, or interacting with the section.
Learn more about Section animations in Stiletto.
Top divider
Display a Solid line above the section to separate it from the above section.
Padding
Add spacing around the section to either the Top and bottom, Top only, Bottom only, or set it to None.