Skip to main content

Create and Publish Homepage Gallery Carousel with new platform

Create and Publish Homepage Gallery (Default) Carousel with new platform

Mikaela Lasig avatar
Written by Mikaela Lasig
Updated over 2 weeks ago

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

Click Launchpad → Go to Website → Choose Homepage Gallery


How to Design/Customize Carousel

​Design tab - This is where you can control which videos you want to use in your Carousel, and where the settings are also located.



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

The Behavior settings control how videos play, appear, and interact within your video feed.

  • Make videos shoppable
    Enables product tagging so viewers can shop directly from the video.

  • Auto play
    Automatically plays videos when they appear on screen.

  • View feed in fullscreen
    Allows videos to open in a fullscreen viewing experience.

  • Auto scroll to next video
    Automatically moves viewers to the next video after the current one finishes.

  • Auto-Display Video Description
    Shows the video description by default without requiring user interaction.

  • Display creator handle
    Displays the creator’s social handle on the video.

  • Open link to creator’s profile
    Makes the creator handle clickable, linking to their social profile.

  • Always start on mute
    Videos will start muted by default.

  • Enable video captions
    Displays captions or subtitles on videos when available.

  • Disable multi-product view
    Limits the video to showing one product at a time instead of multiple products.

  • Hide wishlist
    Hides the wishlist (heart/save) option from the player.

  • Player position
    Choose whether the video player appears on the left or right side.

    Product card

  • Sale Products

    • Only show sale products
      When enabled, the video feed will display only products that are currently on sale. Products not marked as on sale will be hidden from the feed.

    Multi-Product Page

    These settings control how the multi-product view appears when a video is tagged with more than one product.

    • Title
      Toggles the display of the title at the top of the multi-product page.

    • Divider
      Shows or hides a visual divider between sections.

    • Divider Title
      Displays a title label on the divider for clearer separation.

    • CTA text
      Customize the call-to-action button text (for example, View product).

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 project

📝 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.


  • 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

  1. 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.

Did this answer your question?