> ## Documentation Index
> Fetch the complete documentation index at: https://withlooksy.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting Virtual Try-On

> Fix common issues with Looksy virtual try-on. Troubleshoot technical problems, validation errors, and rendering issues.

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

<Check>
  The AI handles any background, lighting, angle, or photography style. Don't reshoot products or adjust images to fix try-on issues.
</Check>

## Common Issues and Solutions

### Try-On Button Doesn't Appear

<AccordionGroup>
  <Accordion title="App Embed Not Enabled">
    **Problem:** The most common issue—app embed is disabled in theme settings

    **Solution:**

    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
  </Accordion>

  <Accordion title="Browser Cache">
    **Problem:** Old version of page is cached

    **Solution:**

    1. Hard refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
    2. Clear browser cache
    3. Try incognito/private window
  </Accordion>

  <Accordion title="Theme Compatibility">
    **Problem:** Rare theme conflict

    **Solution:**

    1. Contact support at [support@looksy.ai](mailto:support@looksy.ai)
    2. Include theme name and product URL
    3. We'll investigate and provide custom integration if needed
  </Accordion>

  <Accordion title="Product Manually Disabled">
    **Problem:** Product was disabled in Looksy admin

    **Solution:**

    1. Go to Looksy admin → **Products**
    2. Find the product
    3. Toggle it **ON**
    4. Save changes
  </Accordion>
</AccordionGroup>

## Upload and Validation Issues

### Image Upload Fails or Shows Error

<AccordionGroup>
  <Accordion title="Not a Human Photo">
    **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
  </Accordion>

  <Accordion title="Multiple People in Photo">
    **Problem:** Image shows more than one person

    **Error 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
  </Accordion>

  <Accordion title="Not Enough Body Visible">
    **Problem:** Face-only photo or heavily cropped image

    **Error 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
  </Accordion>

  <Accordion title="File Too Large">
    **Problem:** Image file exceeds size limit

    **Solution:**

    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
  </Accordion>

  <Accordion title="Slow Upload or Timeout">
    **Problem:** Slow internet connection

    **Solution:**

    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
  </Accordion>
</AccordionGroup>

## Processing and Rendering Issues

### Try-On Takes Too Long

<AccordionGroup>
  <Accordion title="Normal Processing Time">
    **Expected time:** 15-20 seconds

    **Why 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
  </Accordion>

  <Accordion title="Slow Internet Connection">
    **Problem:** Results take longer than 30 seconds

    **Solution:**

    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
  </Accordion>

  <Accordion title="Server Load During Peak Times">
    **Problem:** Occasional slower processing during high traffic

    **Solution:**

    * Wait for completion (may take 30-40 seconds during peak)
    * Retry if it fails

    **Note:** Rare issue; most requests complete in 15-20 seconds
  </Accordion>
</AccordionGroup>

### Result Doesn't Appear or Shows Error

<AccordionGroup>
  <Accordion title="Revealing Product Protection">
    **Problem:** Very revealing garments (lingerie, extreme swimwear) may fail to generate

    **Error message:** "Unable to generate try-on for this product"

    **Why:** Protection against misuse

    **Solution:**

    1. Go to Looksy admin → **Products**
    2. Disable try-on for revealing products
    3. This is expected behavior for these product types
  </Accordion>

  <Accordion title="Network Interruption">
    **Problem:** Connection dropped during processing

    **Solution:**

    1. Check internet connection
    2. Click "Try On" again to restart
    3. Ensure stable connection
  </Accordion>

  <Accordion title="Insufficient Credits">
    **Problem:** Account has run out of credits

    **Error 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
  </Accordion>
</AccordionGroup>

## Mobile-Specific Issues

### Button Doesn't Work on Mobile

<AccordionGroup>
  <Accordion title="Mobile Cache">
    **Problem:** Old cached version on mobile browser

    **Solution:**

    1. Close and reopen browser
    2. Clear mobile browser cache
    3. Try different browser (Safari vs. Chrome)
  </Accordion>

  <Accordion title="Tap Target Too Small">
    **Problem:** Button is hard to tap on mobile

    **Solution:**

    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
  </Accordion>
</AccordionGroup>

### Camera Not Working

<AccordionGroup>
  <Accordion title="Camera Permission Denied">
    **Problem:** Browser doesn't have camera access

    **Solution:**

    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"
  </Accordion>

  <Accordion title="Camera Hardware Issue">
    **Problem:** Device camera not functioning

    **Solution:**

    * Use "Upload Photo" option instead
    * Upload existing photo from gallery
    * Take photo with camera app first, then upload
  </Accordion>
</AccordionGroup>

## Color and Appearance Issues

### Colors Look Different Than Expected

<AccordionGroup>
  <Accordion title="Product Photo Color Is Inaccurate">
    **Problem:** Source product image has wrong colors

    **Solution:**

    * 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
  </Accordion>

  <Accordion title="Selfie Lighting Affects Perception">
    **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
  </Accordion>

  <Accordion title="Screen Display Differences">
    **Problem:** Different devices show colors differently

    **Why 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
  </Accordion>
</AccordionGroup>

## Technical Configuration Issues

### Button Styling Doesn't Match Theme

<AccordionGroup>
  <Accordion title="Default Theme Styling">
    **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
  </Accordion>

  <Accordion title="Button Position">
    **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
  </Accordion>
</AccordionGroup>

## 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

<AccordionGroup>
  <Accordion title="Not Enough Activity Yet">
    **Problem:** Very few customers have used try-on

    **Solution:**

    * Wait for more usage
    * Promote the feature to customers
    * Check back after 1-2 weeks

    **Note:** Dashboard needs activity to display metrics
  </Accordion>

  <Accordion title="Wrong Date Range Selected">
    **Problem:** Viewing a period with no activity

    **Solution:**

    * Check date range filter in dashboard
    * Expand to "All time" or "Last 30 days"
  </Accordion>
</AccordionGroup>

### Return Rate Not Showing

<AccordionGroup>
  <Accordion title="Not Available in Looksy Dashboard">
    **Clarification:** Looksy does NOT track return rates

    **Why:** Return data lives in Shopify, not Looksy

    **Solution:**

    * 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
  </Accordion>
</AccordionGroup>

## Getting Support

If you've tried these solutions and still have issues:

**Contact Looksy Support:**

* Email: [support@looksy.ai](mailto:support@looksy.ai)
* In-app chat: Available in Looksy admin dashboard

**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

<AccordionGroup>
  <Accordion title="Do I need to improve my product photos?">
    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.
  </Accordion>

  <Accordion title="Why do some products work better than others?">
    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.
  </Accordion>

  <Accordion title="Can Looksy fix poor product photography?">
    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.
  </Accordion>

  <Accordion title="Should I disable try-on for certain products?">
    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.
  </Accordion>

  <Accordion title="How do I know if it's working correctly?">
    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.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Common Issues" icon="wrench" href="/troubleshooting/common-issues">
    Fix other common problems
  </Card>

  <Card title="Image Requirements" icon="image" href="/product-setup/image-requirements">
    Learn what helps with try-on accuracy
  </Card>

  <Card title="Best Practices" icon="star" href="/product-setup/best-practices">
    Optimize your overall setup
  </Card>

  <Card title="Support" icon="life-ring" href="mailto:support@looksy.ai">
    Contact support for help
  </Card>
</CardGroup>