The dashboard
The dashboard lives at www.cabina.io/dashboard . You sign in with a link sent by email: no password to remember.
Of everything you find inside, two settings decide whether Cabina works at all. The rest is polish.
The two that matter
Authorised domains — Widget & Branding
The list of sites Cabina is allowed to run on. If your store is not on the list, the browser blocks the requests and the button never appears.
https://shop.com and https://www.shop.com are two different origins. If
your store answers on both, add both: to a browser they look nothing alike.
Only https is accepted, plus http://localhost for development.
The same list protects your credits: a try-on requested from a site that is not
on it is refused before anything is consumed. At install, Wix registers
the site’s address on its own and Shopify registers the .myshopify.com one; a
Shopify store’s own domain (for example www.shop.com) and any other domain your
store answers on must be added here.
API key — Install
The key the widget uses on your store. It starts with cab_live_ and is shown
once.
It is public by design: it sits in your page source, in plain sight. What protects it is the domain list above, not secrecy. This key only reads: metrics, sessions, configuration, size tables.
The Admin API key (cab_admin_) is a different thing: it is for writing and
for the MCP server, and it must stay secret. Never put it in a page.
The rest, briefly
| Section | What it is for |
|---|---|
| Overview | Sessions used, credits, plan status |
| Metrics | How many try-ons, on which products, with what outcome |
| Widget & Branding | Button colour and label, logo, language, categories, domains |
| Size Tables | Your sizes, used to suggest the right one |
| Mix & Match | Pairings between garments |
| Install | The key, the snippet and the per-platform instructions |
| MCP Server | Configure Cabina in natural language, from an AI assistant |
| API | The REST API (/api/v1): metrics, sessions, configuration, size tables and plan, from your own systems |
| Billing | Plan, credits, invoices |
Showcase with QR code
For a physical store without a website. On the Mix & Match page, enter the
store name and an address (lowercase letters, digits and hyphens) and save: the
showcase is at cabina.io/en/negozio/<address>. Print the QR code of that link
and put it in the shop: whoever scans it sees the garments of your Mix & Match
collections, opens one and tries it on in the fitting room, size included if you
have uploaded your charts. Try-ons use your credits, as on a website.
Turning the showcase on adds https://cabina.io to the widget’s authorised
domains; turning it off leaves it there. Search engines do not index the page.
Size charts: in centimetres
Chart measurements go in centimetres, as whole numbers. A row whose maximum bust, waist or hips is below 45 (30 in children’s charts) is rejected: those look like inches. CSV import follows the same rule: whole numbers from 0 to 300 only — no decimals, no “cm” after the number.
In children’s charts the threshold is 30 cm, so baby sizes fit too (chest from about 33 cm): that is why you should pick the right audience when you create the chart.
Size charts: adults or children
Every chart has a Who it is for field: Adults (16 and over) or Children and teens (up to 15). On garments covered only by children’s charts the widget shows 18 under-16 preset models (girls and boys, ages 7–9, 10–12 and 13–15, three body types) and never asks for the shopper’s photo: no photos of minors are collected. The size still comes from your chart, from the measurements in centimetres.
Today a chart applies to a category, not to a single product: if the same category has both an adult chart and a children’s chart, the widget asks the shopper who will wear it: for a child under 16 it shows only the preset models, and either way it looks for the size in that audience’s charts.
The size recommendation
The widget suggests a size only from the shopper’s real measurements: typed in, estimated from the photo, or worked out from height and weight. Each kind of garment needs the ones that matter:
| Garment | Measurements needed |
|---|---|
| Tops, outerwear, dresses | Bust and waist |
| Trousers and skirts | Waist and hips |
| Shoes | Foot (estimated from height if missing) |
If they are missing, no size appears: no recommendation beats an invented one. An out-of-range value typed in the form (inches, for example) is ignored.
How the button looks
Colour and label are chosen in Widget & Branding. The button inherits your theme’s font, so it does not look out of place.
The logo appears in the fitting room header: PNG, JPG or WEBP, 512 KB maximum.
Language: one detail worth knowing
Widget & Branding has a default language. It matters less than it looks.
The fitting room follows the language of the page (<html lang>), and only
if that is missing does it fall back to the browser’s language, and only then to
the one you picked here. Since almost every theme declares the storefront
language, in practice this setting is usually overridden — and rightly so: a
store selling into France shows the fitting room in French without you touching
anything.
The button label, on the other hand, is whatever you type: it is not translated. If you sell in several languages, pick wording that works for all of them, or change it when you change market.
When the widget disappears on its own
If your plan runs out of sessions, or your credits are exhausted, Cabina hides itself, silently. That is not a fault: it is the choice not to break your store. You see it in Billing, and that is where you pick it back up; otherwise the button comes back on its own when your credits renew — every 30 days on plans paid through Shopify or Wix.
Closing your account
You close it from Install, section Close your account. A plan paid by card is cancelled automatically. If your plan is billed through Shopify or Wix, the dashboard stops and tells you so: first uninstall the Cabina app from Shopify or Wix — that is what cancels the plan — then come back and close the account.