Vonili Fit / Documentation
Documentation
Vonili Fit documentation
Every setting, what shoppers see, how Luna decides a size, plan limits and data handling. New here? Start with the step-by-step tutorial.
On this page: What shoppers see · How Luna decides · Find my size block · Cart size check · Luna's pick · Sizing sources · Admin settings · Findings and catalog checks · Fit Profiles · Plans and limits · Data and privacy
What shoppers see
A Find my size button on products with a size option and at least two sizes. It opens a side panel on desktop and a bottom sheet on phones (swipe down, tap outside or press Esc to close).
- Only what the product needs. Tops and dresses ask for height and weight with optional bust, waist and hip; bottoms add inseam and rise; kids' items ask for age; shoes ask for foot length instead of height; rings ask for finger size; hats for head size.
- Their own words. A note such as "5'5", 150 lb, usually M, like it loose" is read in many languages and units, and Luna replies in the shopper's language. Window labels are in English.
- Checked input. Unusual or impossible values are flagged with a suggested fix, for example a weight typed in the height box. Nothing is changed silently.
- The answer. One size with a reason, fit bars comparing body and garment, badges such as Chart checked or Estimated fit, other sizes to compare, stock notes, and an Add to bag button that uses your store's own add to cart.
- One more measurement. When a measurement would decide between two sizes, Luna asks for it and shows where to measure.
- Ask Luna. After the answer, shoppers can tap one of Luna's suggested questions for that product or type their own, about fit, length, fabric or layering. Questions are counted per person, per product, for 24 hours. When the product details don't answer a question, Luna says so. She never changes the size in chat.
How Luna decides a size
- The app reads the product's size data and checks it for errors (blank cells, unit mix-ups, flat half-widths, decimal slips). Uncertain values are left out rather than guessed. This product work is cached, so later shoppers skip it.
- The size solver measures the shopper against every size, adding room for their fit preference, the fabric's stretch and the design.
- Luna, powered by OpenAI, decides the size from that evidence and what the shopper said, and writes the explanation.
- The code checks her choice. It replaces her size only for hard facts: a size that isn't sold, one that measurably doesn't close, or a move away from the measurements with nothing to support it. Every number in an explanation must exist in the evidence.
- Specialist checks cover shoes, boots, rings, bras and kids' sizes. Confidence is lowered when evidence is thin.
If the AI service is unavailable, the shopper still gets an answer from the chart maths. Every plan gets the same Luna.
Find my size block settings
Added on product templates in the theme editor.
| Setting | What it does |
|---|---|
| Button text | The button label (default "Find my size") |
| Button style | Measuring tape, Filled tape or Simple outline |
| Tape colour | Border, tape marks and sparkle colour |
| Measuring figure | Automatic from the product, Women or Men, for the "What to measure" illustration |
| Fit Profile page link | Where "Edit Fit Profile" goes (default: account home) |
| Show on products with only one size | Off by default |
| Luna's pick for returning shoppers | Off by default; Growth and Unlimited |
| Colour source | Automatic (match the section), Light, Dark or Custom colours |
| Custom colours and corner roundness | Button, text, panel, card, border and link colours; 0–24 px corners |
| Custom CSS | Applies only inside the block, so it can't affect the rest of the store |
Automatic colours read your theme's section background, text and button colours, fonts and corner radius, and keep text readable (at least 4.5:1 contrast). They update live in the theme editor.
Cart size check (Growth and Unlimited)
An app embed named Luna cart size check, so it works on any theme. It adds a card near checkout. Luna checks every sized item in the cart against that product's own chart and adds a small badge to each row. Nothing changes without a tap: the review sheet offers Switch to and Keep for each piece. Up to 8 sized lines are checked; each check uses one size answer, cached for the visit. The cart check is in English for now.
| Setting | Options |
|---|---|
| Show on the cart page / in the cart drawer | On by default |
| Where the card goes | Above checkout, below checkout, below the cart items, or a custom spot (CSS selector) |
| Badges beside each item | On by default |
| Check automatically | On by default; checks when saved answers cover a piece |
| Title, subtitle, accent colour | Card wording and colour |
Luna's pick (Growth and Unlimited)
For returning shoppers with saved answers that cover the product, the button changes to My pick · L after the button has been on screen for a few seconds. A tap opens Luna's full answer at once. Nothing is selected or added for the shopper. Each pick uses one size answer, at most 10 per browser per day, and the cart size check reuses it.
Where Luna reads sizing from
- Sources: product description (tables, text charts and sentence charts), size chart images, product and variant metafields and metaobjects, saved fallback charts, and optionally product tags, category and vendor.
- Rules: per collection, product type, vendor or product, mark a source as Primary (used first), Fallback (only when Primary is missing or broken), Supporting (context only) or Ignore. More specific rules win. Conflicting sources are never averaged.
- Fallback charts: paste a table or rows such as
S Bust 86 cm Waist 68 cm, scoped by product type, category, vendor, collection or product ID. - Product inspector: "What is the AI trusting for a product?" shows every source, its quality and role, and exactly what is sent to the AI.
Admin settings
| Setting | Options |
|---|---|
| Alert email | Any email, with Send test email |
| Products ship from | China, United States, United Kingdom, European Union, Turkey, Vietnam, India, Bangladesh, Pakistan, Indonesia, South Korea, Japan or Other |
| Size labels on your products | Automatic, Chinese, Japanese, Korean, US, UK, EU or International letters. A product's own chart always comes first |
| Ask adults to re-measure after | 6, 12, 18 (default), 24 or 36 months |
| Ask for kids' sizes again after | 3, 6 (default), 9 or 12 months |
Sizing findings and catalog checks
Sizing findings list chart problems Luna has confirmed: wrong numbers, typos corrected for shoppers, sizes missing from a chart, charts that disagree, unit mix-ups, flat and full widths mixed, size labels out of order, unclear values and products with no chart. Choose I fixed it (checked again immediately), Dismiss or Edit product. The app never edits your products.
Catalog health (Growth and Unlimited) checks recent products, up to 100 selected products, or the whole catalog in the background, with pause, resume and cancel. Unchanged products reuse earlier work. Edited products are re-checked automatically.
Fit Profiles
- Guests can keep their sizes on their own device.
- Signed-in shoppers can save to their Shopify customer account and use their sizes on every device, from the window or the My Fit Profile account page.
- Family: each person has their own answers and Ask Luna conversation. People per customer: Free 1, Starter 3, Growth 8, Unlimited unlimited. A downgrade never deletes anyone; it only stops new people being added.
- Shoppers can edit or delete their data at any time, and Shopify's customer deletion requests remove it.
Plans and limits
| Plan | Size answers a month | Luna questions per person, per product | People per customer |
|---|---|---|---|
| Free | 100 | 3 | 1 |
| Starter, $9.99 | 1,000 | 5 | 3 |
| Growth, $29 | 3,000 | 7 | 8 |
| Unlimited, $79 | 10,000 | 14 | Unlimited |
A size answer is one full recommendation. Cached repeat answers, input checks and Ask Luna questions don't count. Every plan has a 20% buffer; after that, size help pauses until the 1st of the next month (UTC) or until you upgrade, and shoppers can still choose a size on the page. There are no overage charges. Starter adds daily chart error emails; Growth adds the cart size check, Luna's pick, catalog checks, the fit journey report and verified sales; Unlimited adds priority support. Prices are in USD per month; yearly billing costs ten times the monthly price. Paid plans have a 14-day free trial.
Data and privacy
Shopper names, emails, addresses and payment details are not stored. Data is never sold or used for ads, and OpenAI API data is not used for training. Analytics and sales reporting run only with shopper consent, using anonymous IDs. Read the Privacy Policy and the Data Processing Addendum.
Support
Email support@vonili.com. For privacy requests, email privacy@vonili.com. See the changelog for recent updates.