The Carousel feature allows you to showcase multiple videos in a scrollable, interactive format right on your homepage. It’s a great way to highlight your brand identity, promote products, and guide users deeper into your site with shoppable links — all in one dynamic section.
What Can You Feature in the Carousel?
Use your homepage carousel to tell your brand story and guide customers through your top content.
Popular use cases:
Brand’s Unique Identity – Show what sets your brand apart.
Community / Influencers – Feature UGC, influencer shoutouts, or collabs.
Bestsellers – Highlight top-selling products with shoppable CTAs.
Promotions – Showcase seasonal offers or limited-time discounts.
Sizing / Matching / Choosing – Help customers with how-tos or guides.
Best Practices
To make the most out of your homepage carousel:
Add a Title – Provide context with a clear section heading.
Include Shoppable Links – Direct viewers to a product detail page (PDP) or collection.
Use Expanded Widget – Keep the experience embedded (vs. fullscreen pop-out) for seamless browsing.
Feature Multiple Videos – Keep the carousel lively and diverse.
Strategic Video Order – Prioritize key content first (e.g. bestsellers or promos up top).
Refresh Content Often – Keep the experience fresh and aligned with campaigns.
Steps on how to create
1. Click the Publish tab
2. Click New Project
3. Select the Homepage Gallery card
4. Click start creating
How to Design/Customize Carousel
Media tab - This is where you can control which videos you want to use in your Carousel, and where the settings are also located.
Under the Media tab, you will see two subsections
Don’t have tagged videos yet? Here’s a help article to help you get started Tagging videos in Tolstoy library: How to Tag Products in Tolstoy
1. Playlist
When you click the "+ Add Playlist" button, you can choose from the different playlists in your Tolstoy account, including any custom playlists you’ve created.
On this page, you’ll see all the videos and images in your Spotlight project
Hover over the media and you will see two options:
Eye icon - Lets you hide or unhide the image or videos
Pin icon - Lets you pin the videos to retain the order, sequence or arrangement of the videos
📝 Note: Need to rearrange your videos? Simply drag and drop the media and pin to retain the order. See tutorial here.
Add Media - Lets you add more images and videos from your library
2. Settings - This is where you control how your gallery or videos behave.
Mode
PDP Mode - Only related the tagged videos will display
Non PDP Mode - All tagged videos are displayed, including those that are not related to the product.
Video Recency - Show only videos uploaded within a certain time period. This helps keep your gallery fresh with recent content.
Blacklist Playlists - Exclude videos from specific playlists. Use this if there are certain playlists you don’t want to appear in the gallery.
Design Tab - Where you can customize the appearance of your Spotlight
Widget
Arrows position/style - Choose where the navigation arrows appear and how they look.
Side – Arrows appear on the left and right sides of the carousel.
Bottom – Arrows appear below the carousel.
Show progress bar - Toggle this on to show a small progress bar under your videos.
Minimum number of videos - Set the minimum number of videos that must appear before the carousel layout activates.
Border radius - Controls how rounded the corners are on each video tile.
Motion Settings
Static - Arrows and motion controls stay visible at all times
Dynamic - Controls appear only when the user interacts with the carousel.
Hover Over - Arrows only show when the user hovers their mouse over the carousel.
Scrolls carousel - Arrows move the entire carousel left or right.
Scrolls video - Arrows switch between videos instead of moving the whole carousel.
Responsive - Item size automatically adjusts based on screen width.
Fixed - Item size stays the same on all screens.
Item height - Sets the height (in pixels) of each tile (ex: 300px).
Horizontal spacing - Controls the space between each video tile.
Horizontal padding - Adds padding inside the carousel container from left and right.
Vertical padding - Adds padding inside the carousel container from top and bottom.
Display creator handle - Turn this on to show the creator’s username/handle on each tile.
Creator handle position - Choose where the handle appears:
Open link to creator’s profile - Opens the creator’s profile when their handle is clicked.
Border thickness - Sets how thick the border is around each video.
Border color - Choose the border color using a color picker or hex code.
Title toggle - Turn on to display a title above your carousel.
Text - Add your title (example: “Featured Videos”).
Text size - Adjust how large the title text appears.
Text weight - Controls how bold the text looks (e.g., 400 = normal).
Text color - Set the color of your title text.
Location - Choose where the video’s name appears:
Under – Below the video tile
Over – On top of the video
Text size - Controls how large the tile label text is.
Text color - Choose the color for the video title text.
Background - Turn on to enable a background behind the play button.
Background color - Choose the background color of the play button.
Border - Turn this on to add a border around the play button.
Opacity - Controls how transparent the play button is.
Video Feed
Make videos shoppable - Turns your videos into shoppable content. When enabled, viewers can click products cards and shop button that appear inside the video.
Auto play - Automatically starts playing the video as soon as it loads.
View feed in fullscreen - Allows users to open the entire video feed in fullscreen mode.
Auto scroll to next video - When a video ends, it automatically advances to the next one.
Auto-Display Video Description - Will automatically show the original post description form social account
Display creator handle - Shows the creator’s username/handle on the video.
Open link to creator’s profile - Makes the creator handle clickable and redirects users to the creator’s profile page.
Always start on mute - All videos begin muted. Users can manually unmute if they want to hear the audio.
Enable video captions - Displays captions/subtitles if the video has them.
Disable multi-product view - Hides the expanded product list when multiple products are linked to the video.
Hide wishlist - Removes the wishlist button so users cannot save items.
Player Position - Allows you to choose where the video player appears inside the layout.
Left – Player is aligned to the left side.
Right – Player is aligned to the right side.
Sale Products - Only show sale products
Multi-Product Page Settings - These settings apply to the page where multiple products linked to a video are displayed.
Title - Turn this on to show a title at the top of the multi-product page.
Title Text - Add your custom title (e.g., “Products in this video”).
Divider Settings - Adds a visual divider line between sections.
Divider Title - Shows a label above the divider.
Divider Text - Add a short text label for the divider (e.g., “More products”).
CTA Text - Controls the text on the product button.
Example: “View product”, “Shop now”, “Learn more”.
Product Card
Product price - Toggle on to display the product’s price on the product card.
Mini CTA - Adds a small call-to-action button directly on the product card.
Button type – Choose how the button appears (e.g., text or text and price).
Text – Customize the CTA text.
Primary Button - The main action button that appears on the in feed.
Action - Choose what the button does: Add to cart, Product Page, Buy now, etc.
Text - Customize the button label (e.g., “Add to cart”).
Secondary Button -A secondary action button shown beneath the primary button.
Action - Choose the action (same options as Primary).
Text - Customize what the button says.
Description collapsed by default - Product descriptions start hidden. Users must click to expand.
Always show full description - Description is always fully visible without needing to click.
Checkout & shopping bag -Adds checkout or shopping-bag icons/buttons for quicker purchasing.
Sales Badge - Used to highlight sale items on the product card.
Text - Customize what the badge says (ex: “Sale”, “20% Off”).
Text color - Set the text color for the badge.
Background color - Choose the background color of the sale badge.
Border - Toggle to add a border around the badge.
Border thickness – Adjust how thick the border is.
Border color – Choose the border color.
Shipping Message - Displays a shipping badge or small message on the product card (ex: “Free shipping” or “Fast delivery”).
Text - Enter your shipping message.
Text color - Adjust the color of the shipping message.
Font weight - Choose how bold the text appears:
Light
Regular
Bold
Stock Status - Shows whether a product is in stock or out of stock.
In stock color - Choose the color used when an item is available.
Out of stock color - Choose the color used when the item is not available.
Recommended Products - Displays additional suggested items under the main product.
Section title - Add a title for this section (e.g., “Handpicked for you”).
Settings Tab - where you can further configure language and additional tracking
Font facing language - ability to choose or change the language of this project
Google Analytics tracking – Allows you to add a Google Tag ID so you can track this specific project in your Google Analytics and monitor its performance.
Facebook Pixel tracking – Lets you add your Facebook Pixel ID to track and measure user actions related to this specific project on your website.
Step on How to Publish your Carousel
Click the Publish button
2. Enable the Tolstoy app in your App Embed inside your Shopify theme editor by clicking Open my theme
Click the Next button once you're done.
📝Note: You can skip these if you already enabled the Tolstoy app in your App embeds
3. Copy your publish ID, then click Add block
The Carousel block will be automatically added to your theme. Click the block and paste the publish ID.