> ## 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.
# Understanding Looksy Credits
> Learn how Looksy's credit system works, how to estimate usage, when to upgrade, and how to monitor your credit balance.
## What are Looksy Credits?
**Credits** are Looksy's usage-based currency. Each time a customer completes a virtual try-on on your store, it consumes **1 credit** from your account.
**1 try-on = 1 credit consumed**
Credits are deducted only when a try-on result is successfully generated. Failed uploads or errors don't consume credits.
### How Credits Work
1. **Customer clicks "Try On"** on your product page
2. **Customer uploads a selfie** or takes a photo
3. **Looksy processes the image** (15-20 seconds)
4. **Try-on result is displayed** to the customer
5. **1 credit is deducted** from your balance
**What doesn't consume credits:**
* Button clicks without completing try-on
* Failed uploads (unsuitable images, errors)
* Testing try-on yourself (still consumes credits, but necessary for setup)
***
## Credit Plans
Every Looksy plan includes a monthly credit allocation:
| Plan | Monthly Credits | Effective Try-Ons\* | Price |
| ----------- | --------------- | ------------------- | ----------- |
| **Free** | 25 credits | \~100 try-ons | \$0/month |
| **Starter** | 200 credits | \~800 try-ons | \$29/month |
| **Growth** | 1,000 credits | \~4,000 try-ons | \$79/month |
| **Pro** | 3,000 credits | \~12,000 try-ons | \$149/month |
\*Most customers try 2-4 products, so 1 credit often leads to multiple try-on attempts.
Credits reset monthly on your billing date. Unused credits don't roll over, so plan accordingly.
***
## How Many Credits Will I Use?
Use this calculator to estimate your monthly credit needs:
### Credit Usage Calculator
**Step 1: Estimate Monthly Visitors**
How many people visit your product pages each month?
* Check Shopify Analytics → Online Store → Sessions
* Focus on product page visits (not homepage)
**Step 2: Estimate Engagement Rate**
What % of visitors will use virtual try-on?
* **First month (low awareness):** 5-10%
* **After promotion (emails, homepage banner):** 15-25%
* **Mature feature (3+ months):** 20-35%
**Step 3: Calculate Credits Needed**
```
Monthly Credits = Monthly Visitors × Engagement Rate
```
**Examples:**
**Small store (500 product page visitors/month):**
* Conservative (10% engagement): 500 × 0.10 = **50 credits**
* Optimistic (20% engagement): 500 × 0.20 = **100 credits**
* **Recommended plan:** Free (25 credits) or Starter (200 credits)
**Mid-size store (5,000 product page visitors/month):**
* Conservative (15% engagement): 5,000 × 0.15 = **750 credits**
* Optimistic (25% engagement): 5,000 × 0.25 = **1,250 credits**
* **Recommended plan:** Growth (1,000 credits) or Pro (3,000 credits)
**Large store (20,000 product page visitors/month):**
* Conservative (20% engagement): 20,000 × 0.20 = **4,000 credits**
* Optimistic (30% engagement): 20,000 × 0.30 = **6,000 credits**
* **Recommended plan:** Pro (3,000 credits) or contact sales for custom plan
Start with a conservative estimate. It's better to upgrade mid-month than to over-purchase credits you won't use.
***
## What Happens When You Run Out of Credits?
**When your credit balance reaches 0:**
1. **Try-on stops working** – Button may hide or show "out of credits" message
2. **Your store continues working normally** – No impact on product pages or checkout
3. **You're notified via email** – Alert sent when you hit 20% remaining and 0% remaining
4. **You can upgrade immediately** – Add more credits by upgrading your plan
Plan ahead! Running out of credits mid-month means customers can't use virtual try-on until you upgrade or your credits reset next billing cycle.
### Grace Period
**Free plan:** No grace period (feature stops at 0 credits)
**Paid plans:** 50-credit emergency buffer to prevent sudden shutoff
This buffer prevents the feature from stopping abruptly if you exceed your plan by a small amount.
***
## When to Upgrade Your Plan
### Signals It's Time to Upgrade
**1. You're consistently using 80%+ of your credits**
* Current plan is too small
* Upgrade before you run out
**2. You've run out of credits mid-month**
* Clear sign you need a larger plan
* Upgrade immediately to restore functionality
**3. Traffic is growing**
* More visitors = more try-ons
* Upgrade proactively to avoid running out
**4. Engagement is higher than expected**
* If 30%+ of visitors use try-on, you'll need more credits
* Good problem to have! Upgrade to support demand.
**5. You're seeing strong ROI**
* If virtual try-on is driving conversions and reducing returns
* Investing in more credits pays for itself
Upgrade when you hit 80% of your credits. Don't wait until you're at 100% and the feature stops working.
### How to Upgrade
1. Go to **Looksy Dashboard → Plans & Billing**
2. Click **"Upgrade Plan"**
3. Select the plan that fits your needs
4. Confirm and update billing
5. New credits are available immediately
**Pro-rated billing:** You only pay for the remaining days in your billing cycle.
***
## How to Monitor Credit Usage
### Check Your Balance
**In Looksy Dashboard:**
1. Open Looksy app in Shopify admin
2. Dashboard shows current credit balance at top
3. See daily usage chart
**Key metrics to watch:**
* **Credits remaining:** How many credits left this month?
* **Credits used today:** Current daily usage
* **Average daily usage:** Credits per day over last 7 days
* **Days until reset:** When your credits refill
### Set Up Usage Alerts
**Automatic email alerts:**
* **80% used:** "You've used 80% of your monthly credits"
* **100% used:** "You're out of credits – upgrade to restore virtual try-on"
These alerts help you avoid running out unexpectedly.
### Usage Patterns to Watch
**Healthy usage:**
* Steady daily usage (10-20 credits/day)
* Gradual increase as feature gains awareness
* Peaks on weekends or during promotions
**Concerning patterns:**
* Sudden spike (possible issue or viral post)
* Very low usage despite high traffic (button not visible? lack of promotion?)
* Running out before mid-month (need to upgrade)
Check your dashboard weekly to stay aware of usage trends and avoid surprises.
***
## Optimizing Credit Usage
### Get More Value from Each Credit
**1. Promote the Feature**
* Homepage banner
* Email announcements
* Social media posts
* Product page callouts
Higher awareness = more usage = better ROI per credit
**2. Focus on High-ROI Products**
* Enable try-on on products with highest return rates
* Disable products with very low engagement
* Use analytics to identify winners
**3. Improve Product Images**
* Better images = better results = higher engagement
* Multiple angles (up to 4 images per product)
* Clear, high-resolution photos
**4. Monitor and Adjust**
* Use analytics to see which products perform best
* Disable low-performers if credits are tight
* Focus credits on products that drive conversions
***
## Credit Usage Examples
### Example 1: Fashion Boutique (Small Store)
**Profile:**
* 800 product page visits/month
* 20% engagement rate
* 160 try-ons/month
**Recommended plan:** Starter (200 credits) – $29/month **Cost per try-on:** $0.18
**ROI:** If converts 10% of try-ons at $75 AOV = $1,200 revenue on \$29 investment = **4,000% ROI**
***
### Example 2: Activewear Brand (Mid-Size)
**Profile:**
* 8,000 product page visits/month
* 25% engagement rate
* 2,000 try-ons/month
**Recommended plan:** Pro (3,000 credits) – $149/month **Cost per try-on:** $0.07
**ROI:** If converts 15% of try-ons at $95 AOV = $28,500 revenue on \$149 investment = **19,000% ROI**
***
### Example 3: Multi-Brand Retailer (Large Store)
**Profile:**
* 30,000 product page visits/month
* 30% engagement rate
* 9,000 try-ons/month
**Recommended plan:** Enterprise (custom) – Contact sales
**Cost per try-on:** \$0.03-0.05 (volume pricing)
**ROI:** High-volume stores see best unit economics
***
## Common Questions
Yes, credits reset monthly on your billing date. Unused credits don't carry over to the next month. Use them or lose them.
No, credits are tied to your plan. To get more credits, you need to upgrade to a higher tier. Contact sales for custom plans if standard tiers don't fit.
Paid plans have a 50-credit emergency buffer. You won't be immediately cut off if you exceed your plan slightly. But the feature will stop once the buffer is consumed.
Yes. When you test virtual try-on yourself during setup, those test try-ons consume credits. Factor in 5-10 credits for testing when choosing your plan.
Yes. You can downgrade at any time. Changes take effect on your next billing date. Downgrade if you're consistently using \< 50% of your credits.
You may run out of credits mid-month. Upgrade immediately to restore functionality. For predictable spikes (sales, holidays), upgrade proactively before the event.
Credits are non-refundable. If you're consistently not using your credits, downgrade to a smaller plan for future months. Unused credits don't carry over.
***
## Credit Management Best Practices
### 1. Start Conservative
* Begin with Free plan (25 credits) or Starter (200 credits)
* Monitor usage for 2-4 weeks
* Upgrade based on actual usage, not estimates
### 2. Check Dashboard Weekly
* Monitor credit balance every Monday
* Track daily usage trends
* Adjust plan if needed mid-month
### 3. Upgrade Proactively
* Don't wait until you hit 0 credits
* Upgrade at 80% to avoid interruption
* Plan for seasonal spikes (holidays, sales)
### 4. Use Analytics to Optimize
* Identify high-ROI products
* Disable low-performers if credits are tight
* Focus credits where they drive most value
### 5. Promote the Feature
* Higher engagement = better ROI per credit
* Email subscribers about virtual try-on
* Add homepage banner
* Mention in product descriptions
Well-managed credits deliver 5-10x ROI. Monitor usage, upgrade when needed, and focus on high-impact products.
***
## Next Steps
See all plan options and pricing
Monitor your credit usage in real-time
Measure the return on your credit investment
Maximize value from every credit