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

# Install Looksy on Shopify

> Installing Looksy takes 2 minutes. The app auto-enables all products and works immediately—no setup required.

<Note>
  **Choose your setup guide:**

  * **Want the fastest install?** You're on the right page – this is the 2-minute quick install guide
  * **Want comprehensive setup with optimization tips?** See [Complete Setup Guide](/getting-started/quick-setup)
  * **Have theme integration questions?** See [Theme Integration Guide](/integration/theme-setup)
</Note>

## Getting Started with Looksy

Looksy is AI virtual try-on for Shopify. Customers upload a photo and see how your products look on them. The app works out of the box with zero configuration.

## Installation (2 Minutes)

### Step 1: Install from Shopify App Store

1. Visit the [Looksy app page](https://apps.shopify.com/looksy) on the Shopify App Store
2. Click **Add app**
3. Approve the installation in your Shopify admin
4. You'll land in the Looksy dashboard

**You're automatically subscribed to the free plan (25 credits).**

### Step 2: Enable the Try-On Button

The "Try On" button displays on your product images. Enable it using Shopify's app embed:

1. During onboarding, click the button that takes you directly to app embeds
2. Find **Looksy Try-On Button** in the app embeds list
3. Toggle it on
4. Click **Save**

**That's it.** The button now appears on all product pages.

<Tip>
  The button uses your theme's styling (fonts, colors) by default. You can customize it later if needed.
</Tip>

### Step 3: Test It

1. Visit any product page on your store
2. Click **Try On** (button appears on the product image)
3. Upload a selfie
4. Wait 15-20 seconds for the result

***

## How It Works

When a customer clicks "Try On":

1. They upload a photo
2. Looksy validates the image (must be one person, human, showing enough body)
3. The image and your product images (max 4) run through our image-to-image AI model
4. The processed result displays on the product page

**Image validation protects your credits.** If the image is unsuitable (cartoon, animal, multiple people, insufficient body showing), the customer gets an error explaining what's wrong.

***

## Managing Products

**By default, Looksy enables all products.** This works for most stores.

### Disable Specific Products

If certain products don't work well with try-on, disable them:

1. Go to **Products** in your Looksy admin
2. Find the product you want to disable
3. Toggle it off

<Warning>
  **Revealing products may struggle:** Lingerie, swimwear, and very revealing garments might fail to generate results. This protects against misuse. Disable these products if you encounter issues.
</Warning>

### Select Specific Products Only

To use try-on on only certain products:

1. Go to **Products** in your Looksy admin
2. Click **Disable All**
3. Enable only the products you want

***

## Customizing the Button

The button uses your theme's styling by default. To customize:

1. Go to your Looksy dashboard
2. Click **Customize button**
3. Adjust settings:

**Position:**

* Top Left
* Top Right

**Text & Colors:**

* Button Text (default: "Try On")
* Text & Icon Color
* Background Color

**Advanced:**

* Icon Style (Sparkle / No Icon)
* Icon Size & Weight
* Font Size & Weight
* Font Family (uses Store Body Font by default)
* Border Radius
* Padding

Changes apply immediately to all product pages.

***

## What You Get with Looksy

* **AI Virtual Try-On** – Customers see products on themselves in 15-20 seconds
* **Automatic Product Integration** – Works on all products by default
* **Analytics Dashboard** – Track engagement and conversion impact
* **Theme Integration** – Uses your theme's styling automatically
* **Mobile Optimized** – Works on desktop and mobile with no extra setup
* **Multi-language Support** – Button text adapts to your store's language

***

## Free Plan

Everyone starts on the free plan:

* **25 try-on credits** included
* **Full features** (no limitations)
* **No credit card required**
* **No time limit** (credits never expire)

Upgrade when you need more credits.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Test Your First Try-On" icon="flask" href="/getting-started/first-try-on">
    Walk through the customer experience
  </Card>

  <Card title="Best Practices" icon="star" href="/product-setup/best-practices">
    Get the most out of virtual try-on
  </Card>

  <Card title="Supported Products" icon="shirt" href="/product-setup/supported-products">
    See which products work best
  </Card>

  <Card title="View Pricing" icon="dollar-sign" href="/faq/pricing-and-plans">
    Explore paid plans when you're ready
  </Card>
</CardGroup>

***

## Common Questions

<AccordionGroup>
  <Accordion title="Do I need to configure anything?">
    No. The app auto-enables all products and works immediately. You only need to toggle on the app embed.
  </Accordion>

  <Accordion title="Does it work on mobile?">
    Yes. The app works on desktop and mobile with no additional setup. If it works on desktop, it works on mobile.
  </Accordion>

  <Accordion title="What if I only want try-on on certain products?">
    Go to Products in your Looksy admin, disable all, then enable only the products you want.
  </Accordion>

  <Accordion title="Do I need to activate a plan?">
    No. You're automatically on the free plan (25 credits) when you install. Just enable the app embed and it works.
  </Accordion>

  <Accordion title="Can I customize how the button looks?">
    Yes. Click "Customize button" in your dashboard to change colors, text, size, and styling. You can also choose top left or top right corner position. The button uses your theme's styling by default.
  </Accordion>
</AccordionGroup>

***

Need help? Email [support@looksy.ai](mailto:support@looksy.ai) or use the in-app support chat.