Troubleshooting the quote widget

Use this guide when the embed does not load, shows an error state, or submissions fail. The settings page checklist shows which setup steps Handlet has confirmed.

Domain not allowed

Symptom: The iframe shows that the quote form is not enabled for a host, often with the detected host name.

Fix:

1. Open Settings → Website quote widget → Install.
2. Add the detected host exactly as shown (for example cdpn.io, not codepen.io).
3. Save and reload the embedding page.

If you test inside CodePen or JSFiddle, allow both the editor host and the preview host (see the install guide).

Referrer policies and iframe embedding

Some sites send Referrer-Policy: no-referrer or sandbox the iframe. Handlet also reads window.location.ancestorOrigins in supporting browsers, but you should still allow-list the real embedding host.

Fix:

• Relax referrer policy for the page that embeds Handlet, or
• Ensure the allowed domain matches the host shown in the browser address bar for the parent page.

Rate limits

Symptom: Visitors see a message to try again shortly, sometimes with a countdown.

Cause: Public widget endpoints rate-limit per embed key and IP to prevent abuse.

Fix:

• Wait for the countdown to finish.
• Avoid hot-reloading the iframe in a tight loop while developing.
• If legitimate traffic hits limits, contact Handlet support with your widget id and timeframe.

Address lookup not available

Symptom: Intelligent mode cannot find addresses after a postcode is entered.

Cause: Address search requires OS Places to be configured for the Handlet environment and intelligent quoting to be enabled for the widget.

Fix:

1. Confirm the widget quoting mode is Intelligent quote.
2. Check the settings page for pricing-intelligence readiness blockers.
3. If the message persists in production, contact support — the feature may be disabled or over quota.

Session expired

Symptom: The visitor sees that the session expired and should refresh.

Cause: Embed sessions are short-lived. Visitors who pause for a long time may need a refresh. Handlet renews sessions automatically during normal activity when possible.

Fix:

• Ask the visitor to refresh the page.
• Avoid leaving a half-completed form open for hours during testing.

Submissions do not appear in the inbox

Checklist:

1. Widget is Active.
2. Allowed domain matches the live site.
3. Embed key in the snippet matches the current active key.
4. Setup checklist shows Verify installation and Send a test submission complete after a test.

If submission fails with a generic error, try once more after refreshing. Persistent failures may indicate a workflow configuration issue — note the time and contact support.

CAPTCHA and bot protection

Handlet v1 does not show a visitor-facing CAPTCHA on the widget. An invisible anti-spam ladder runs server-side instead. You do not need to install reCAPTCHA or hCaptcha on your site for the widget to work.

Related

• Installing the quote widget