askthe.bot

Troubleshooting

The 90% of issues people hit, and the 30-second fix for each.

"Domain not allowed" / widget refuses to open

Try-on agents are locked to your store domain(s). Open the agent's Profile tab → Allowed domains and add the exact host you're embedding on (no protocol, no path).

  • Add brand.com — auto-allows www.brand.com and shop.brand.com.
  • Don't add https:// or trailing slashes.
  • Staging on a different host (e.g. brand.myshopify.com)? Add it too.

Floating button doesn't appear

  1. Open browser devtools → Console. Look for [askthe.bot] messages.
  2. In Network, filter for askthe.bot. tryon.js or embed.js should be 200.
  3. If neither loads: a Content Security Policy is blocking it. Add askthe.bot to script-src and connect-src.
  4. If they load but no button: data-auto-button="false" is set somewhere — remove it, or add your own data-tryon-trigger button.

Modal opens but image upload fails

  • Most often: your customer is on a flaky mobile connection. Have them retry.
  • Check the file size — we cap at ~10MB. The widget downscales to ≤768px before upload, so anything over usually means a browser extension is intercepting.
  • Safari private mode disables localStorage — the visitor ID gets regenerated each session, but uploads still work.

Render comes back distorted / wrong

  1. Make sure productImage is the actual product, not a lifestyle shot. Packshot > lifestyle.
  2. Use the largest available source image (Shopify image_url: width: 1200, WP 'full', etc.).
  3. Provide productLabel — the model uses it as a hint.
  4. For specific issues (color too dark, fit too loose), tweak the agent's Personality → Try-on prompt in the dashboard.

Wrong color / can't swap variants

See Variants & color swaps — pass productImage per-variant at click time using the JS API.

Chat embed shows the wrong agent / old config

  • Hard-refresh — the embed bundle is cached for 5 minutes.
  • Confirm data-agent matches the slug shown on your agent's Publish tab.

CORS / "Refused to connect" in console

Your CSP needs:

script-src  'self' https://askthe.bot;
connect-src 'self' https://askthe.bot https://*.supabase.co;
img-src     'self' https://askthe.bot data: blob:;
frame-src   'self' https://askthe.bot;

Still stuck?

Hit the floating Feedback button on any page, or email hello@askthe.bot. Include the page URL and a screenshot of the browser console.

Also see FAQ.