Tryon AI documentation

Everything a merchant needs to install, configure and ship with Tryon AI.

1. Install

1. From the Shopify App Store listing, click Add app.
2. Approve the requested permissions: read_products, read_customers, write_customers, read_orders. Each is justified in the privacy policy.
3. On first load you'll see the Setup Wizard. Follow the four steps to reach a usable state in under five minutes.

2. Sync products

Tryon AI keeps a local copy of your product catalogue so size charts and try-on sessions can be attributed to specific products without calling Shopify on every shopper request.

1. Open Products in the app sidebar.
2. Click Sync products now. The first sync pulls your full catalogue (paginated 50 at a time).
3. Re-run sync any time you add new products. The Setup Wizard auto- detects when sync has succeeded.

3. Configure size charts

Each product needs a size chart so the recommendation engine has something to compare body measurements against.

Per-product editor

Click any product in the table to open its size chart editor. Enter one row per size with the relevant dimensions (chest, waist, hip, shoulder, length, inseam — the form adapts to the garment type).

Bulk apply a template

Select multiple products of the same garment type, then Bulk actions → Apply size chart template. Pick a preset (Shirt EU/US/Asia, Pants W/L grid, Dress, Jacket, Skirt) and confirm. Existing charts on the selected products will be overwritten.

Toggle try-on per product

Selecting Bulk actions → Disable try-on hides the widget for those products on the storefront without removing their size charts. Useful for accessories or non-clothing SKUs.

4. Add the storefront widget

Tryon AI ships as a theme app extension. To make it visible on your storefront:

1. Open Online Store → Themes → Customize.
2. Switch the template selector to Products → Default product (the block is restricted to product templates so it cannot be added to the homepage by mistake).
3. In the section that contains your buy buttons (often "Product information"), click Add block → Apps → Tryon AI Virtual Try-On.
4. Drag the block to where you want it (typically below the buy buttons), customise the colour and toggles, then Save.

5. Read the analytics

Open Analytics in the sidebar. Last-30-day metrics:

• Conversion uplift — try-on shoppers vs. baseline conversion rate.
• Revenue from try-on — order revenue attributed to a try-on session.
• Refund-rate (try-on) — proxy for fit-related returns; compare to baseline refund rate.
• Customer funnel — try-on → recommendation → cart-add → order.
• Top products by try-on volume with per-product recommendation acceptance rate.

Attribution works by stamping _tryonai_session_id on the cart when a shopper completes a try-on. The nightly /cron/rollup job pulls orders from the Admin API and matches that attribute back to the session. Click Refresh data on the Analytics page to run an on-demand rollup.

6. Enable AI features (optional)

The default size recommender is a deterministic rule-based engine. Three AI features are available behind operator-controlled flags:

• ML size recommendation — Claude Haiku or Gemini 2.5 Flash, ~$0.0005/call. Toggle via RECOMMENDER=ml-claude or RECOMMENDER=ml-gemini + the corresponding API key. Falls back to rule-based on any error.
• Photo-based measurement — capture a body photo instead of typing measurements. Powered by Replicate pose estimation. Photos are processed in memory only and never stored.
• AI virtual try-on image (Pro) — generates a preview image of the customer wearing the product. Pro plan + 50 generations/month cap + cached 30 days per (customer, product).

Each AI feature is opt-in and falls back gracefully if the provider is unavailable. See Privacy for how third-party data sharing works.

7. Troubleshooting

Widget shows "Size recommendations are not available"

The product hasn't been synced into Tryon AI yet, or its size chart is empty. Re-sync from Products, then add a chart.

Widget shows "This product hasn't been synced"

The block was added to a non-product template (homepage or collection). Move it into the Product template via theme editor.

Setup Wizard says "publish to theme" but widget doesn't appear

Theme app extensions are not enabled by default. The block must be added explicitly through the theme editor — see section 4.

Recommendations look wrong

Verify the size chart matches the actual garment dimensions (cm). The wrong template applied to the wrong garment type (e.g. a shirt template on jeans) will produce unhelpful recommendations.

8. Privacy & data handling

Body measurements are encrypted at rest with AES-256-GCM. Photos uploaded for AI measurement are processed in memory only and never persisted. Generated try-on images live for 30 days, then are purged by the hourly /cron/cleanup job. See the full Privacy Policy.

GDPR webhooks (customers/data_request, customers/redact, shop/redact) are implemented per Shopify spec; data subject requests are honoured within Shopify's 30-day SLA.

More questions? Email dienhv4789@gmail.com or visit the support page.