Introduction
Homepage Spotlight lets you add a shoppable video/media carousel to your homepage. It helps merchants highlight best-selling products, UGC, AI-generated content, launches, or seasonal campaigns in a more engaging storefront experience.
You can set up and preview the widget in Tolstoy, but publishing and embedding Homepage Spotlight on your live store requires a paid plan. If you are on a free plan, Tolstoy will prompt you to upgrade when you try to publish.
Best Practices
Use short, high-quality videos that show the product clearly.
Tag each media asset with the correct product so product cards and clicks work.
Pin your best-performing or most important content first.
Keep the homepage selection focused. Too many unrelated videos can make the Spotlight feel less intentional.
Check the widget on desktop and mobile after publishing.
Review performance through widget views, video plays, and product clicks.
Troubleshooting / FAQs
Why is the Publish button asking me to upgrade?
Publishing Homepage Spotlight requires a paid plan.
The widget is published, but I do not see it on my homepage.
Make sure the Tolstoy Builder block was added to the homepage, the embed code was pasted into the Widget Code field, and the Shopify theme was saved.
I changed the media, but the live widget did not update.
Click Publish update.
Why are product cards missing?
Product cards appear when media assets are tagged with products. Check that each video/image is connected to the correct product.
How do I remove the Spotlight from my store?
Pause the widget from Tolstoy, or remove the Tolstoy Builder block from your Shopify homepage.