Skip to main content

​
Troubleshooting

​
Error response format

All API errors follow this format: 
{
  "error": "Error message description",
  "hint": "Optional hint for resolution"
}

​
Error codes reference

HTTPErrorCauseSolution
400userPhoto and productImage are requiredMissing fieldsProvide both userPhoto and productImage (URL or Base64)
400Failed to fetch user photo from URLURL not accessibleVerify the URL is publicly reachable
400Failed to fetch product image from URLURL not accessibleVerify the URL is publicly reachable
400Image too smallImage smaller than 1 KBSend a valid, full-size image
401Authentication requiredMissing header or invalid keySend your key in the X-API-Key header (not a query param)
402Insufficient creditsNo creditsPurchase credits in your dashboard
402Payment past dueSubscription failedUpdate your payment method
403API key is inactiveKey deactivatedCreate a new key
403Domain not authorizedOrigin not whitelistedAdd your domain to the key’s whitelist
403Origin header requiredMissing headerAdd Origin header to your request
422ai_content_rejectedContent rejected by the AI engineUse compliant, appropriate images
500AI generation failedAI model errorRetry; contact support if persistent
500Failed to save resultStorage errorRetry; contact support if persistent
A 404 from Cloudflare ({"error":"requested path is invalid"} with a CF-RAY header) is not a Wearo error — the request URL is wrong. The correct endpoint is POST https://api.wearo.io/functions/v1/tryon-api.

​
Widget button not appearing

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 →
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.
Look for [TryOnWidget] messages in your browser console. Error messages will indicate what went wrong.

​
Button appears in the wrong position

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;
}
Your selector matches more than one image. Restrict to the first:
productSelector: '.product__media:first-child img'

​
Image quality issues

  • Use photos minimum 500×500px
  • Ensure good lighting in customer photos
  • Use product images with clean backgrounds

​
Still stuck?

Book a 15-min debug call

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.