Troubleshooting
Cabina never breaks your storefront: when it cannot work, it removes itself. That is deliberate, and it is also why some of these failures are completely silent.
The quoted lines below are what the browser actually prints: look for them in the console exactly as written, not translated.
No button anywhere on the product page
In the console: a CORS error from your browser, naming www.cabina.io
Your store domain is not on the authorised list, so the API answers without CORS headers and the browser drops the response.
Add the exact origin at Widget .
https://shop.com and https://www.shop.com are two different origins: add
both if both serve the store.
No button, and no CORS error either
In the console: [widget] error=WIDGET_CONFIG_MISSING
The API key is missing, or it was not read from the script tag.
Check that data-api-key sits on the <script> tag itself and starts with
cab_live_.
No button, nothing in the console at all
In the console: nothing — this one is silent
Your plan has run out of sessions, or your credits are exhausted. The widget hides itself on purpose, so your store keeps working.
Check Billing .
The button sits at the very bottom of the page
In the console: nothing — this one is silent too
None of the known anchors matched your theme, so the button was appended to
<body>.
Add <div data-cabina-target></div> where you want it: the button goes
inside that element. See
Moving the button.
Two buttons, and sessions counted twice
In the console: [widget] warn=GIA_CARICATO
The snippet is on the page twice — often an old copy plus a plugin.
Remove one of the two <script> tags.
The button opens, but the try-on fails partway
In the console: nothing
Cabina could not find the garment image on the page.
Add an og:image meta tag to your product template — see
The garment image.
Verifying from a terminal
# 1. the tag is actually served
curl -s https://your-store.com/products/some-product | grep -o 'widget.iife.js'
# 2. the page exposes a garment image
curl -s https://your-store.com/products/some-product | grep -o 'og:image[^>]*'These are the two that fail. If both answer, the problem is almost always the unauthorised domain.
None of these cases?
Write to info@cabina.io with a link to a product page and, if you can, what you see in the console.