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

# Configure Shopify

> Configure storefront appearance, customer access, limits, and shopper copy.

Use Shopify's theme editor for storefront presentation. Use virtual.fit for product availability, customer access, and usage limits.

## Theme editor settings

Open **Shopify admin → Online Store → Themes → Customize → App embeds → Virtual Fitting Room**.

### Button and guidance

| Setting                    | What it changes                                      |
| -------------------------- | ---------------------------------------------------- |
| **Button Text**            | Label shown on the product media control.            |
| **Upload Hint Text**       | Photo guidance shown before upload.                  |
| **Generate Button Text**   | Label on the action that starts a try-on.            |
| **Try-On Button Position** | Left or right placement over the main product media. |

Use short labels that fit narrow mobile galleries. Keep upload guidance specific: ask for a clear, well-lit photo showing the shopper from the front.

### Appearance

Turn on **Customize Appearance** to set:

* Background color and opacity.
* Text color.
* Theme font preset.
* Border style, color, and thickness.
* Theme, custom, or pill corner style.

Use **Advanced CSS Overrides** only when the standard controls cannot match your theme. Re-test custom values after theme updates.

### Product card badges

Product card badges can show which products support try-on before a shopper opens the product page.

* Turn **Show Try-On Badges on Product Cards** on or off.
* Set the badge text and left or right placement.
* Reuse the try-on button appearance or style the badge separately.

<Tip>
  Confirm badges appear only on Active products and never cover pricing, sale, or inventory badges. Check both collection grids and search results on mobile.
</Tip>

### Terms and email

The app embed supports:

* Automatic language detection, English, or Estonian disclaimer copy.
* A custom short disclaimer and full terms.
* Optional email collection.
* Required email validation when collection is on.
* A custom daily-limit message.

<Warning>
  Merchant terms and privacy notices are your responsibility. Review custom legal copy with your counsel. Describe results as AI previews, not guarantees of physical fit, size, color, or proportion.
</Warning>

## virtual.fit settings

Open **Setup** in virtual.fit.

<AccordionGroup>
  <Accordion title="Customer access">
    Choose **Allow anonymous** for the lowest-friction experience, or **Require login** when every try-on must be tied to a known customer. If login is required, verify that Shopify returns the shopper to the same product page.
  </Accordion>

  <Accordion title="Customer daily limit">
    Set how many try-ons one shopper may start per day. Test the limit message so it gives the shopper a clear next step.
  </Accordion>

  <Accordion title="Result retention">
    Shopper uploads and generated results are automatically deleted after 24 hours. Treat exported or downloaded files according to your own privacy policy.
  </Accordion>
</AccordionGroup>

Safety checks are always applied to shopper uploads. There is no storefront setting required to turn them on.

## Recommended order

<Steps>
  <Step title="Confirm product readiness">
    Wait for initial preparation to finish, then check a representative group of apparel products.
  </Step>

  <Step title="Set access and limits">
    Decide whether signed-out shoppers can use virtual.fit and choose a suitable daily limit.
  </Step>

  <Step title="Match the theme">
    Configure placement, button appearance, badges, and copy in the theme editor.
  </Step>

  <Step title="Review shopper notices">
    Confirm terms, photo guidance, email behavior, and translated text.
  </Step>

  <Step title="Test every state">
    Test signed in, signed out, limit reached, rejected photo, generation failure, and successful completion.
  </Step>
</Steps>

<Info>
  Theme settings change presentation only. Product state, plan limits, and customer access continue to apply.
</Info>