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.
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 |
| Catalog Views | How your garments are seen by the engine |
| 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 & Webhooks | REST API and notifications to your systems |
| Billing | Plan, credits, invoices |
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.