Troubleshooting

Error response format

All API errors follow this format:

{
  "error": "Error message description",
  "hint": "Optional hint for resolution"
}

HTTP	Error	Cause	Solution
400	`userPhoto and productImageUrl are required`	Missing fields	Provide both `userPhoto` and `productImageUrl`
400	`Failed to fetch user photo from URL`	URL not accessible	Verify the URL is publicly reachable
400	`Failed to fetch product image from URL`	URL not accessible	Verify the URL is publicly reachable
401	`API key is required`	Missing header	Add `X-API-Key` to your request
401	`Invalid API key`	Key not found	Check for typos in your key
402	`Insufficient credits`	No credits	Purchase credits in your dashboard
402	`Payment past due`	Subscription failed	Update your payment method
403	`API key is inactive`	Key deactivated	Create a new key
403	`Domain not authorized`	Origin not whitelisted	Add your domain to the key’s whitelist
403	`Origin header required`	Missing header	Add `Origin` header to your request
500	`AI generation failed`	AI model error	Retry; contact support if persistent
500	`Failed to save result`	Storage error	Retry; contact support if persistent

Check the product selector

Open DevTools and test your selector in the console:

document.querySelectorAll('.product__media img')

If it returns 0 elements, your selector doesn’t match. Inspect the product image and copy its class or ID.Custom selectors guide →

Image too small

The widget doesn’t inject on images smaller than 150px wide to avoid cluttering thumbnails. Ensure your main product image is at least 150px wide.

Check the console for errors

Look for [TryOnWidget] messages in your browser console. Error messages will indicate what went wrong.

Button appears below the image or misaligned

This happens when your image container is wider than the image itself.CSS fix:

.your-product-image-container {
  width: fit-content;
}

Manual positioning:

#tryon-trigger-host {
  margin-top: 12px;
}

Multiple buttons appear

Your selector matches more than one image. Restrict to the first:

productSelector: '.product__media:first-child img'

We’ll diagnose the issue live on your store.

Or email us at support@wearo.io with your store URL and a screenshot of the browser console.