Skip to main content

AI Widget Prompt & Design Guide

Written by Mikaela Lasig

Make your Tolstoy widgets look and work exactly how you want using simple AI prompts!
​

With Tolstoy's AI Widget Builder, you can customize your widget's design, layout, colors, fonts, video appearance, and functionality just by describing what you'd like to change in the AI chatbox. No coding experience is needed for basic customization.

Below are ready-to-use prompts you can copy, paste, and adjust to match your store's branding and preferences.
​

How to Customize Your Widget

  1. Open your Tolstoy dashboard and go to Widgets.

  2. Select the widget you'd like to customize.

  3. Find the AI chatbox inside your widget project.

  4. Type or paste any of the example prompts below.

  5. Review your changes in the preview. Once you're happy with the result, click Publish or Publish update, as applicable.

Tip: You can also upload screenshots or share a website URL as a design reference to help the AI understand the look you're trying to achieve.


1. Widget Size & Layout

Use these prompts to adjust your widget's overall appearance, dimensions, and positioning.
​

  • Resize the widget

Make my widget smaller and more compact without affecting the video quality.

  • Adjust widget width

Make the widget take up 100% of the available page width on desktop.

  • Adjust widget spacing

Reduce the spacing between each video card to 8px.

  • Adjust the number of visible videos

Display 5 videos per row on desktop and 2 videos per row on mobile.

  • Center the widget

Center the widget horizontally on the page and keep the spacing equal on both sides.

  • Adjust widget padding

Add 20px padding around the widget and maintain consistent spacing between all elements.

  • Change widget alignment

Align all video cards to the left instead of centering them.

  • Adjust card corners

Make all video cards have rounded corners with a border radius of 12px.


2. Colors, Fonts & Branding

Match your Tolstoy widget to your store's visual identity.

  • Change background color

Change the widget background color to white (#FFFFFF).

  • Change button colors

Make all buttons black with white text. When hovered, change the button background to dark gray.

  • Change font family

Use Arial as the font family for all text inside the widget.

  • Adjust font size

Make the widget heading 24px and the product descriptions 14px.

  • Change text color

Make all headings black and descriptions dark gray.

  • Match your website design

Match my widget's fonts, colors, buttons, and overall styling to my website: [Insert your website URL].

  • Copy a design reference

Use the attached screenshot as a design reference. Match the video card size, spacing, colors, and overall layout as closely as possible.

  • Add borders

Add a thin light-gray border around each product card.

  • Add shadows

Add a subtle shadow behind each video card to create a clean, modern appearance.


3. Video Appearance & Thumbnails

Customize how your videos look before shoppers click or interact with them.

  • Resize video thumbnails

Make all video thumbnails smaller while maintaining their original aspect ratio.

  • Change thumbnail shapes

Change my video thumbnails from rectangular to circular.

  • Change video aspect ratio

Display all video cards in a 9:16 vertical aspect ratio.

  • Adjust video cropping

Make sure video thumbnails fill their containers without stretching or distorting the content.

  • Change play button design

Make the play button smaller, white, and positioned in the center of each video.

  • Hide video titles

Remove the video titles underneath each thumbnail.

  • Shorten video captions

Limit video captions to a maximum of 2 lines and truncate longer text with an ellipsis.

  • Add hover effects

When a shopper hovers over a video thumbnail, slightly enlarge the thumbnail with a smooth transition.


4. Mobile & Desktop Design

Create a responsive experience that looks great on any device.

  • Customize mobile layout

Display 2 video cards per row on mobile while keeping 5 cards visible on desktop.

  • Resize videos on mobile

Make video thumbnails smaller on mobile screens without changing their desktop size.

  • Improve mobile spacing

Reduce the spacing between video cards on mobile to 6px.

  • Make the widget mobile-friendly

Optimize my widget for mobile devices. Make sure all videos, buttons, and text fit properly without horizontal overflow.

  • Adjust mobile text size

Reduce the widget heading font size to 18px on mobile while keeping it 28px on desktop.

  • Hide elements on mobile

Hide the widget heading on mobile devices but keep it visible on desktop.

  • Enable horizontal scrolling

On mobile, display video cards in a horizontally scrollable carousel instead of stacking them vertically.


5. Carousel Customization

Customize how your Homepage Carousel or other carousel widgets display videos.

  • Change carousel navigation

Add left and right navigation arrows to my carousel.

  • Customize navigation arrows

Make the carousel navigation arrows circular with a white background and black icons.

  • Enable automatic scrolling

Automatically move to the next video in the carousel every 5 seconds. Pause when the shopper interacts with it.

  • Enable infinite scrolling

Make the carousel loop continuously so shoppers can keep browsing videos.

  • Adjust carousel spacing

Reduce the gap between carousel videos to 10px.

  • Change carousel title

Change the carousel heading to "Shop Our Favorites" and center it above the videos.

  • Hide carousel arrows on mobile

Hide the navigation arrows on mobile and allow shoppers to swipe through videos instead.


6. PDP Stories Customization

Customize the appearance and behavior of video stories on product pages.

  • Resize story circles

Make the PDP Story thumbnails 60px in diameter on mobile and 80px on desktop.

  • Change story thumbnail shape

Change the PDP Story thumbnails from circles to rounded squares.

  • Change story borders

Add a 2px black border around each story thumbnail.

  • Adjust story spacing

Add 12px spacing between each story thumbnail.

  • Customize story labels

Display short labels beneath each PDP Story thumbnail using a 12px font.

  • Hide story labels

Remove the text labels underneath my PDP Story thumbnails.

  • Adjust story placement

Position the PDP Stories below the product title and above the product price.

  • Customize watched stories

Change the border color of watched stories to light gray while keeping unwatched stories black.


7. Video Player Customization

Control what shoppers see when they open and watch videos.

  • Change video player size

Make the video player occupy 80% of the screen width on desktop.

  • Open videos in full screen

When shoppers click a video thumbnail, open the video in a full-screen player.

  • Customize close button

Make the video player's close button larger and position it in the top-right corner.

  • Change player background

Change the background behind the video player to black.

  • Adjust video controls

Show the play, pause, mute, and unmute controls in the video player.

  • Enable autoplay

Automatically play the first video when the video player opens.

  • Mute videos by default

Start all autoplay videos muted and allow shoppers to turn on the sound manually.

  • Close the player when clicking outside

Close the video player when a shopper clicks outside the video area.


8. Product Cards & Shopping Buttons

Customize the shopping experience inside your videos.

  • Change Add to Cart button

Change the Add to Cart button background to black, with white text and rounded corners.

  • Change button text

Replace the "Add to Cart" button text with "Shop Now".

  • Adjust product card layout

Display the product image on the left and the product title, price, and Add to Cart button on the right.

  • Change product price styling

Make product prices bold and use a 16px font size.

  • Hide product descriptions

Hide product descriptions and display only the product name, price, and Add to Cart button.

  • Change button width

Make the Add to Cart button fill the entire width of the product card.

  • Customize sold-out products

When a product is out of stock, disable the Add to Cart button and display "Sold Out".


9. Widget Positioning & Visibility

Control where and when your widgets appear.

  • Show widgets only on selected pages

Show this widget only on collection pages and hide it from the homepage and product pages.

  • Display widget after scrolling

Show the widget only after a shopper scrolls halfway down the page.

  • Hide widget on mobile

Hide this widget on mobile devices but keep it visible on desktop.

  • Hide widget on desktop

Display this widget only on mobile devices.

  • Delay widget appearance

Display the widget 3 seconds after the page finishes loading.

  • Set widget position

Position the floating widget in the bottom-right corner of the screen with 20px spacing from the edges.

  • Prevent overlapping elements

Make sure my floating widget does not overlap the website's chat button or other important elements.


10. Advanced Functionality & Store Integrations

You can also ask the AI Widget Builder to help customize how shoppers interact with your videos and store.

These examples may require theme-specific functions, custom events, or additional configuration. Replace the sample names with the functions and events used by your website.

  • Use your store's cart drawer

When a shopper clicks Add to Cart, add the item using my theme's cart functionality and automatically open the cart drawer. My theme uses window.theme.cart.addItem(variantId, quantity) and window.theme.cart.open().

  • Open your store's quick view

When a shopper clicks a product inside my widget, open my store's quick view instead of navigating to the product page. My quick view uses a "quickview" event with the product URL in its detail.

  • Open the video player from a website button

On product pages, open the Tolstoy video player in full screen when a shopper clicks my "Watch Videos" button with the ID "watch-videos".

  • Close the video player when the cart opens

Automatically close the full-screen video player when my store's cart drawer opens so shoppers can view their cart.

  • Send events to Google Tag Manager

Push events to my Google Tag Manager dataLayer when a shopper plays a video, clicks a product, or adds a product to the cart. Use the event names tolstoy_video_play, tolstoy_product_click, and tolstoy_add_to_cart.

  • Prevent conflicts with your store's features

Make sure my widget works with my store's existing cart drawer and product quick view without replacing or breaking their functionality.


Tips for Writing Better AI Prompts

For the best results:

  1. Be specific. Instead of saying "Make my videos smaller," try "Make my video thumbnails 80px wide on mobile."

  2. Include exact measurements. Use pixels, percentages, colors, or dimensions whenever possible.

  3. Share references. Upload screenshots or provide website URLs to show the design you want.

  4. Mention mobile and desktop. Specify whether a change should apply to mobile, desktop, or both.

  5. Make changes one at a time. This makes it easier to review the results and refine the design.

  6. Tell the AI what should stay unchanged. For example, "Only change the button color. Keep the existing layout, fonts, and spacing."

Did this answer your question?