Troubleshooting

Common embed and API failures — and how to unblock them fast.

Widget does not appear

• Confirm widget.js 200 in Network tab
• Check data-project / Feedback.init project key
• Look for [OpenRoadmap] warnings in the console
• Ensure the script is not blocked by an ad blocker / CSP

Submit returns 403

Domain allowlist rejected the host. Add your site hostname to the project allowlist (localhost ports for local demo).

CORS errors from dashboard / portal

Add the frontend origin to Worker ALLOWED_ORIGINS. Rebuild/redeploy the Worker after changing vars.

UI panel never opens

• widget-ui.js must be reachable (same CDN or __OPENROADMAP_UI_URL__)
• Check for mixed content (HTTPS page loading HTTP assets)

Emails missing

Without RESEND_API_KEY, mail is mocked — inspect /emails in the dashboard (outbox API). With Queues bound, confirm the consumer is deployed on the same Worker.

Memory store reset