Skip to main content

​
Looksy Works With Any Images

Virtual try-on works with your existing Shopify product images—no special photography or adjustments needed. Most issues are technical or configuration-related, not image quality problems.
The AI handles any background, lighting, angle, or photography style. Don’t reshoot products or adjust images to fix try-on issues.

​
Common Issues and Solutions

​
Try-On Button Doesn’t Appear

Problem: The most common issue—app embed is disabled in theme settingsSolution:
  1. Go to Online Store → Themes → Customize
  2. Click App embeds in left sidebar
  3. Find Looksy Try-On Button
  4. Toggle it ON
  5. Click Save
Verify: Visit a product page and check for the “Try On” button on the product image
Problem: Old version of page is cachedSolution:
  1. Hard refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
  2. Clear browser cache
  3. Try incognito/private window
Problem: Rare theme conflictSolution:
  1. Contact support at [email protected]
  2. Include theme name and product URL
  3. We’ll investigate and provide custom integration if needed
Problem: Product was disabled in Looksy adminSolution:
  1. Go to Looksy admin → Products
  2. Find the product
  3. Toggle it ON
  4. Save changes

​
Upload and Validation Issues

​
Image Upload Fails or Shows Error

Problem: Uploaded image is not a person (cartoon, animal, illustration)Error message: “Please upload a photo of a person”Solution:
  • Upload a real photo of a human
  • No drawings, cartoons, animals, or illustrations
  • Must be an actual person
Why: Protects your credits from misuse
Problem: Image shows more than one personError message: “Please upload a photo with only one person”Solution:
  • Use a photo with a single person only
  • Crop out additional people if needed
  • Take a new selfie with just one person
Why: AI needs to identify one body for accurate rendering
Problem: Face-only photo or heavily cropped imageError message: “Please show more of your body”Solution:
  • Upload a full body shot (works best)
  • At minimum, show enough body for garment placement
  • Don’t use extreme close-ups of just the face
Why: AI needs to see body structure to place garment accurately
Problem: Image file exceeds size limitSolution:
  1. Compress the image before uploading
  2. Use phone’s camera app (automatically optimizes)
  3. Try a different photo
Note: Most phone photos work fine—this is rare
Problem: Slow internet connectionSolution:
  1. Check internet connection
  2. Try again on WiFi (if on cellular)
  3. Use a smaller file size photo
  4. Wait and retry
Note: Mobile networks (4G/5G) work fine—3G may be slower

​
Processing and Rendering Issues

​
Try-On Takes Too Long

Expected time: 15-20 secondsWhy it takes time:
  • AI processes both your photo and product images
  • Runs complex rendering calculations
  • Delivers high-quality realistic results
Not a problem: 15-20 seconds is normal and expected
Problem: Results take longer than 30 secondsSolution:
  1. Check internet speed
  2. Try WiFi instead of cellular
  3. Wait for processing to complete (customer can continue browsing)
Note: Customers can explore the product page while try-on generates
Problem: Occasional slower processing during high trafficSolution:
  • Wait for completion (may take 30-40 seconds during peak)
  • Retry if it fails
Note: Rare issue; most requests complete in 15-20 seconds

​
Result Doesn’t Appear or Shows Error

Problem: Very revealing garments (lingerie, extreme swimwear) may fail to generateError message: “Unable to generate try-on for this product”Why: Protection against misuseSolution:
  1. Go to Looksy admin → Products
  2. Disable try-on for revealing products
  3. This is expected behavior for these product types
Problem: Connection dropped during processingSolution:
  1. Check internet connection
  2. Click “Try On” again to restart
  3. Ensure stable connection
Problem: Account has run out of creditsError message: “No credits remaining”Solution:
  1. Go to Looksy admin → Billing
  2. Upgrade plan or purchase more credits
  3. Free plan includes 25 credits to test
Note: Each try-on uses 1 credit

​
Mobile-Specific Issues

​
Button Doesn’t Work on Mobile

Problem: Old cached version on mobile browserSolution:
  1. Close and reopen browser
  2. Clear mobile browser cache
  3. Try different browser (Safari vs. Chrome)
Problem: Button is hard to tap on mobileSolution:
  1. Go to Looksy admin → Customize Button
  2. Increase Button Padding (try 20-24px)
  3. Increase Text Font Size (try 18px)
  4. Save and test again

​
Camera Not Working

Problem: Browser doesn’t have camera accessSolution:
  1. Check browser settings → Permissions
  2. Allow camera access for your store
  3. Reload page and try again
Alternative: Use “Upload Photo” instead of “Take Photo”
Problem: Device camera not functioningSolution:
  • Use “Upload Photo” option instead
  • Upload existing photo from gallery
  • Take photo with camera app first, then upload

​
Color and Appearance Issues

​
Colors Look Different Than Expected

Problem: Source product image has wrong colorsSolution:
  • Color-correct your product images in Shopify
  • Virtual try-on shows colors as they appear in product photos
  • If product photo is inaccurate, try-on will match that inaccuracy
Note: Try-on renders what it sees in your product images
Problem: Colored lighting in selfie (yellow/blue tint)Why it happens:
  • Indoor tungsten lighting adds yellow tint
  • Blue outdoor light adds cool tint
  • AI compensates but can’t fully eliminate colored lighting
Solution for customers:
  • Suggest using neutral lighting when possible
  • Natural daylight works well
  • Neutral white LEDs work well
Cannot fix: If selfie has strong colored lighting, result will reflect that
Problem: Different devices show colors differentlyWhy it happens:
  • Each screen has different color calibration
  • Mobile vs. desktop displays vary
  • Brightness settings affect perception
Solution:
  • Accept as normal variance
  • Add disclaimer: “Colors may vary by screen”
  • Focus on style visualization, not exact color matching
Cannot fix: Device-specific color calibration is out of our control

​
Technical Configuration Issues

​
Button Styling Doesn’t Match Theme

How it works:
  • Looksy uses your theme’s fonts and colors by default
  • Automatically matches your store design
If you want custom styling:
  1. Go to Looksy admin → Customize Button
  2. Adjust colors, fonts, sizes
  3. Save changes
How it works:
  • Button appears on product image
  • Position options: Top Left or Top Right
To change position:
  1. Go to Looksy admin → Customize Button
  2. Select Button Position: Top Left or Top Right
  3. Save
Note: Button location on product image is fixed—only corner position (left/right) is customizable

​
When Results Don’t Look Realistic

​
Understanding AI Limitations

Important: The AI model is highly realistic across all product types. If results don’t look good, the issue is likely:
  1. Product photos need more angles – Upload up to 4 images showing different views, textures, and details
  2. Technical issue – See troubleshooting sections above
  3. Revealing product protection – Very revealing garments may fail (by design)
Not image quality issues: The AI works with any background, lighting, or photography style.

​
What Actually Helps Results

If you want to maximize accuracy:
  1. Add multiple product images – Show different angles (max 4 images)
  2. Include detail shots – Close-ups of texture, material, patterns
  3. Showcase garment details – Clear views of design elements
Don’t:
  • ❌ Reshoot on plain backgrounds
  • ❌ Adjust lighting or shadows
  • ❌ Remove backgrounds
  • ❌ Change angles to front-facing only
  • ❌ Re-crop or re-frame products
The AI handles all of that automatically.

​
Analytics and Tracking Issues

​
No Data in Dashboard

Problem: Very few customers have used try-onSolution:
  • Wait for more usage
  • Promote the feature to customers
  • Check back after 1-2 weeks
Note: Dashboard needs activity to display metrics
Problem: Viewing a period with no activitySolution:
  • Check date range filter in dashboard
  • Expand to “All time” or “Last 30 days”

​
Return Rate Not Showing

Clarification: Looksy does NOT track return ratesWhy: Return data lives in Shopify, not LooksySolution:
  • Use Shopify analytics to track returns
  • Compare return rates before/after enabling try-on
  • Track style-related vs. sizing-related returns manually
What Looksy tracks: Try-on usage, engagement, conversions

​
Getting Support

If you’ve tried these solutions and still have issues: Contact Looksy Support: Include in your message:
  • Product URL where issue occurs
  • Description of the problem
  • Screenshots if applicable
  • Steps you’ve already tried
Response time: Usually within 24 hours

​
Common Questions

No. Looksy works with your existing product images. The AI handles any background, lighting, or photography style. Don’t reshoot or adjust images to fix try-on issues.
Products with multiple angles and detail shots (max 4 images) give the AI more context. This improves accuracy. It’s not about image quality—it’s about variety of views.
Looksy works with any images but can’t improve source photo quality. If your product images show wrong colors or are very low resolution, try-on will reflect that. The AI doesn’t need “good” photos—it just renders what it sees.
Only disable if:
  • Very revealing garments (protection against misuse)
  • You specifically don’t want try-on available for that product
Don’t disable based on image quality or product type—the AI works on everything.
Test it yourself:
  1. Visit a product page
  2. Click “Try On”
  3. Upload a selfie
  4. Check if result looks realistic (15-20 seconds)
If button appears and try-on generates, it’s working correctly.

​
Next Steps

Common Issues

Fix other common problems

Image Requirements

Learn what helps with try-on accuracy

Best Practices

Optimize your overall setup

Support

Contact support for help