Beauty Try-On lets shoppers upload a selfie or portrait and preview cosmetic products on themselves. This helps merchants show shades and looks before purchase and can reduce buying hesitation. Merchants can set up Beauty Try-On before it is live, but publishing it to a live storefront requires a paid Shopper plan. On Shopify, it also needs to be placed on the product page template.
How to Set Up
1. Go to Virtual Try-On → Click Experiences → Select Beauty Try-On
2. Click Start setup
3. Choose a product to test → Click Choose Product to proceed
4. Choose a sample photo or upload your own photo → Click Continue
5. Choose the AI model to pick speed or quality → Click Generate Try-on
6. Wait for the model to generate
7. If needed, you can try with a different product or continue
You can also Compare both models to see which model works best for you
8. Click Continue
Customize the Virtual Try-On Button on Your Product Pages
The CTA step lets you customize the button customers use to launch the Virtual Try-On experience from your product pages.
Customize the button label
Under Label, enter the text you want displayed on the button.
For example:
Try it on
Virtual Try-On
See it on you
Choose wording that clearly tells customers what will happen when they select the button.
Select a button style
Choose the design that best matches your storefront:
Outlined: A clean button with an outlined border
Filled: A solid button using your selected accent color
Pill: A rounded, capsule-shaped button
Luxe: A premium, double-bordered design
Choose the button position
Select where and how the button should appear on the product page:
Inline: Displays the button within the product-page content
Full-width: Expands the button across the available content area
Floating: Keeps the button visible in a floating position
Set the accent color
Choose one of the available colors or enter a custom color to match the button with your brand and storefront design.
Add a leading icon
Choose an optional icon to display with the button label:
Sparkle: Adds a sparkle icon
Pulse dot: Adds a simple attention indicator
None: Displays the label without an icon
Configure placement and eligibility
Expand Placement and eligibility to access additional design, sizing, and visibility settings for the CTA.
Colors
Customize each part of the button using a color name or value:
Background Color: Sets the button’s background color
Text Color: Sets the color of the button label
Border Color: Sets the button’s border color
Accent Color: Sets the color used for highlighted button elements
Hover design
Turn on Custom hover colors to change the button’s appearance when a customer moves their cursor over it.
This allows you to create a separate color combination for the button’s hover state.
Button width
Control the button width separately for desktop and mobile devices.
Fit: Adjusts the button width based on its content
Custom %: Lets you set a specific width percentage
When Custom % is selected, use the width slider to adjust how much horizontal space the button occupies.
Shape and style
Use these settings to further customize the CTA’s appearance:
Link Style: Displays the CTA as underlined text instead of a standard button
Show Icon: Shows or hides the button icon
Custom Icon: Uploads your own icon or uses the default sparkle icon
Icon Position: Places the icon before or after the button text
Border Radius: Controls how rounded the button corners are
Border Width: Adjusts the thickness of the button border
Text Alignment: Aligns the label to the left, center, or right
Font
Customize the button text to match your storefront:
Font Family: Selects the typeface used for the button label
Font Size: Adjusts the size of the text
Letter Spacing: Controls the space between each character
Visibility
Use Blacklist by Collection to prevent the Virtual Try-On CTA from appearing on products within selected collections.
Search for and add any product collections where the CTA should not be displayed. If no collections are added, the CTA remains available on every eligible product.
Reset your settings
Select Reset to default to restore the placement, design, and eligibility settings to their original values.
Preview your changes
Use the mobile preview on the right to see how the CTA will appear on a product page. The preview updates as you adjust the button’s label, style, position, colors, size, and other design options.
Once you are happy with the setup, select Continue to configure the upload flow.
Customize the Virtual Try-On Upload Flow
The Upload flow step controls what shoppers see before uploading a photo. These settings are shared across See It On You, Beauty Try-On, and Video Try-On experiences.
Customize the shopper-facing text
Use the text fields to explain the experience and guide shoppers through the upload process.
Top text: The main heading displayed above the upload area
Body text: A short description explaining what shoppers can expect
Upload button text: The label displayed on the photo-upload button
The preview on the right updates to show how the text will appear to shoppers.
Choose a default silhouette
Select the placeholder image shoppers see before uploading a photo:
Beauty: Uses the default Beauty Try-On silhouette
Custom: Lets you use a custom silhouette that better represents your brand or upload requirements
Enable photo validation
Turn on Photo validation to use AI to check uploaded photos against your validation rules.
This helps ensure that shoppers submit suitable images before the Virtual Try-On result is generated.
Configure validation rules
Validation rules define the requirements an uploaded photo must meet.
Examples include:
The person must meet a minimum age requirement.
The photo must show at least the upper body.
Photos showing only the face, head, or shoulders should be rejected.
To create another requirement:
Enter the instruction under Add a validation rule.
Select Add.
Review the rule to make sure it is clear and specific.
To remove a rule, select the X beside it.
Choose when shoppers sign in
Under Before showing the result, choose when the shopper is asked to identify themselves.
No sign-in required
Shoppers can generate and view their results without signing in. After the result appears, they may see a dismissible prompt encouraging them to sign in and save it.
Sign in before viewing the result
The uploaded photo is validated first. Once it passes the checks, the shopper must sign in before viewing the generated result.
This is the recommended option when capturing shopper information is an important part of the experience.
Review
Use the preview on the right to see the text, silhouette, and upload button as they will appear to shoppers.
Click Publish → Click Publish Myself
How to Publish
Shopify
1. In the final publish step, click Publish or Publish Myself.
2. If prompted, enable the Tolstoy app embed in Shopify.
3. Click Add block to open the Shopify theme editor for the product page template.
4. Add the Tolstoy try-on block to the product page template. Beauty Try-On uses the same Shopify app block as See It On You.
5. Click Save in Shopify.
6. Open a live product page and confirm the button, upload flow, and try-on result work as expected.
Non-Shopify
1. Click Publish.
2. Copy the Beauty Try-On embed code.
3. Paste the code where you want the experience to appear.
4. Replace the placeholder product ID with your own product ID.
5. Test the experience on a live product page.
Best Practices
-Test Beauty Try-On on a few important products before you publish it across the catalog.
-Keep the upload instructions short and clear so shoppers know to use a clean face photo or portrait.
-Use button text that matches the beauty flow, such as "Try it on" or "Find my shade".
-Review both the Beauty Try-On and Shade Finder settings so the sign-in flow and welcome text match your shopper journey.
Troubleshooting / FAQs
Why is Beauty Try-On still showing as Draft?
It has not been published yet. Open the entry point and finish the publish flow.
Why does the status say Needs placement?
The widget is published, but the Shopify block has not been added to the product page template yet.
Why does the status say Paused?
The widget is published, but the store is not currently billable for Shopper usage. A paid Shopper plan is required to keep it live.
Why can't I see Beauty Try-On in AI Shopper?
Beauty Try-On is only shown for beauty or skincare brands, or for brands that already have an existing Beauty Try-On widget.
Why did my Photo Upload change affect other experiences?
Beauty Try-On uses the shared Photo Upload configuration. Changes there can also affect other photo-based AI Shopper experiences.
Why does the Beauty flow open a shade-finding experience?
Beauty Try-On uses the beauty try-on setup together with the Shade Finder flow. Review both settings pages if you need to change the shopper experience.
Can I get help publishing it?
Yes. In the setup flow, you can choose to book a free setup call if you want help from the team.