Wearo: Virtual Try-On — Documentation for Merchants

What Wearo Virtual Try-On does

Wearo lets your shoppers preview your garments on themselves before they buy. It adds a "Try it on me" button to your product detail pages; when a shopper clicks it, an in-page modal opens, the shopper uploads a photo, and an AI-generated try-on image is rendered in about 15 seconds.

The widget is read-only on your store: it reads your product catalogue (titles, images, variants) so it knows which garment to render, and it never touches orders, customers, or any other resource. We do not request read_orders. We do not collect customer-identifying data.

The app is free in V1: every merchant gets a one-time pack of 50 try-on credits at no cost. There is no recurring charge, no in-app purchase, and no upsell to a paid tier inside the app.

Install the app

Go to the Shopify App Store listing and search for Wearo: Virtual Try-On.
Click Add app, then Install.
You will be redirected into your Shopify admin to grant the OAuth scope read_products. Approve it.
You arrive on the embedded Wearo admin inside your Shopify dashboard. The Home page confirms your install and walks you through three steps.

Total install time: about one minute.

Activate the widget on your storefront

The widget is an App Embed and an App Block, two standard Shopify primitives. You enable them from your theme editor; no code edit, no theme fork, no copy-pasting JavaScript. The two buttons on the Wearo Home page open the right theme-editor screen directly.

Step 1: turn the App Embed on (one click, store-wide)

The App Embed loads the Wearo loader script on every page of your storefront. Without it, the widget cannot run.

In your Shopify admin, go to Online Store → Themes.
On your live (or development) theme, click Customize.
In the left sidebar, click the App embeds tab (the small puzzle-piece icon at the bottom).
Find the Wearo virtual try-on embed in the list and toggle it on.
Click Save (top-right).

That's it for the loader. From this point on, Wearo runs on your storefront in standby, but no button is visible yet, because we have not told it where to put one. That's the App Block.

Step 2: add the "Try it on me" button to your product pages

Still in Customize on your theme, navigate to a Product page template (for example: Products / Default product or any product-template variant you use).
In the left sidebar, find the Product information section (or the equivalent in your theme).
Click Add block.
In the Apps section of the block picker, choose Wearo Try-On Button.
Drag the block where you want the button (typically just above or below your add-to-cart).
Click Save.

The button is now live on every product that uses that template. Add it once per product template you use.

Step 3: verify on your storefront

Open a product page on your storefront in a private/incognito window. You should see a Try it on me button next to your add-to-cart. Click it. A modal opens with the Wearo widget. Upload a photo. In about 15 seconds, you see the AI-generated try-on. If you do, you are done.

Style the button

There is no separate settings screen: the button's appearance lives entirely in the Theme Editor, on the Wearo Try-on button block. Select the block and you can tune, from the block panel:

Inherit theme style — one toggle that adopts your theme's own button class, so the try-on button matches your existing buttons exactly. When on, it overrides the appearance controls below.
Button label — a custom label shows as-is in every language; leave it empty to use the automatic translation ("Try it on me" / "Essayer sur moi").
Button and text colours, corner radius, size (Small / Medium / Large), full width, and a style (Solid, Outline, Minimal) and text style (Default, Spaced uppercase).
Show on mobile.

Changes apply the moment you save the theme. There is nothing to deploy and no caching layer to wait for. In the Outline and Minimal styles, the text colour follows the button colour automatically.

Credits and the try-on button

Your Free plan includes a one-time welcome pack of 50 try-ons. Each generated image uses one credit. When the pack runs out, the try-on button hides itself automatically on your storefront, so shoppers never see a button that can't work. You can watch your remaining credits on the Billing page of the Wearo admin. Need more? Email contact@wearo.io.

Uninstall and data deletion

You can uninstall Wearo at any time from Settings → Apps and sales channels → Wearo: Virtual Try-On → Uninstall in your Shopify admin.

Uninstalling triggers Shopify's app/uninstalled webhook, which we receive immediately and use to mark your shop record as uninstalled. About 48 hours later, Shopify sends us shop/redact, which triggers a cascade deletion of the records we hold tied to your shop. Full details are in our Privacy Policy §3.4.

If you want deletion sooner (rather than waiting for shop/redact), email contact@wearo.io and we will run it within one business day.

What happens to your shoppers' photos

The photo a shopper uploads is transmitted encrypted to our EEA servers, used only to render the try-on they asked for, and not kept beyond that generation. Never used for advertising, profiling, or AI-model training.
If a shopper chooses to reuse the same photo from one product to another, that reusable photo stays on their device, in their browser — it is not stored on our servers outside the generations they request.
The generated try-on images are kept securely (encrypted, EEA-hosted, GDPR-compliant) so shoppers can find their try-ons again, and are deleted on request to contact@wearo.io and automatically when you uninstall the app.

Full details are in our Privacy Policy.

Troubleshooting

The "Try it on me" button does not appear on my product page

Check that the App Embed is enabled (Customize → App embeds → Wearo toggled on, theme saved).
Check that the App Block is added on the product template you use (Customize → that template → Add block → Wearo).
Check that your product has at least one image. The widget cannot render without a product image.
If your storefront is password-protected, our external status check can't see it, but the widget still works for visitors who have the password, and reports itself as active from the first visit.

The widget opens but generation fails

Photo too small or wrong format. We accept JPEG, PNG, and WebP up to ~10 MB. Full-length photos give the best results, especially for dresses and trousers; a head-and-shoulders shot renders poorly for a full garment.
Credit pack exhausted. When you have used all 50 V1 credits, the try-on button hides automatically on your storefront. Email contact@wearo.io if you want a refresh.

The widget is in the wrong language

The widget follows your storefront's language automatically (it reads the storefront locale Shopify forwards on each page). There is no locale setting to configure.

Anything else

Email contact@wearo.io. Please include your shop domain (*.myshopify.com) and a short description of what you tried; we typically respond within one business day.

What Wearo cannot do (yet)

We do not yet support Shopify Hydrogen storefronts. The Theme App Extension is for Liquid-based Online Store 2.0 themes.
Vintage (non-Online-Store-2.0) themes don't support app blocks; write to contact@wearo.io and we'll help you find a path.
We do not yet have a paid tier. When we introduce one, it will be billed through the Shopify Billing API, with explicit consent in your admin before any charge.

These are roadmap items; V1 is intentionally narrow.

Contact

General and support. contact@wearo.io
Privacy / GDPR / CCPA requests. contact@wearo.io with the subject line GDPR - Erasure request or CCPA - Deletion request.
Bug reports. contact@wearo.io with the subject line Bug - Wearo Shopify and brief reproduction steps if you have them.

We aim to acknowledge every inbound query within one business day.