Troubleshooting
Common widget and dashboard issues with fixes.
Widget does not appear
| Check | Fix |
|---|---|
| Missing App ID | Add data-app-id from Apps. Check the browser console for errors. |
| Wrong script URL | Use https://telltide.com/src/widgets/widget.js |
| Script blocked by CSP | Allow script-src for telltide.com in your site's Content Security Policy. |
| Duplicate script | Only one widget.js tag per App ID per page. |
Submissions fail with 403 (origin)
Message: This website is not allowed to submit feedback for the application.
Use one TellTide app per product. The widget on telltide.com must use the TellTide app (TELLTIDE), not another product such as SEO Dispatcher.
| Cause | Fix |
|---|---|
| App link hostname mismatch | Set App link to the live site URL. www and the apex host count as the same site. Other subdomains (app., staging) must be added under Allowed websites. |
| Testing on wrong domain | Use localhost for local dev, or create a separate app for staging. |
| Preview/staging URL | Add the URL under API credentials → Publishable key → Allowed websites, or create a separate staging app. |
| Reused App ID | Do not embed one App ID on two products. TellTide → https://telltide.com. Each other site gets its own app. |
Submissions fail with 401
| Cause | Fix |
|---|---|
| Invalid publishable key | Copy the active tt_pub_… key from the app's credential panel. |
| Invalid private key | Rotate the server key and update the trusted backend secret. |
| Wrong credential type | Use a publishable key for /public/feedback, or Bearer private/token authentication for /feedback. |
Submissions fail with 400
| Cause | Fix |
|---|---|
| Invalid email | Use a valid email format. |
| Review without rating | Star reviews require a 1–5 rating. |
| Invalid type | Use feedback, review, bug, or feature request. |
| Reserved metadata | Do not send priority_level, activity_log, internal_notes, or screenshot_id in feedback_data. Feature urgency belongs in requested_priority. |
Submissions fail with 429
Too many submissions in a short time. Wait a minute and try again.
Config does not match Manage Widget
| Cause | Fix |
|---|---|
| Config not saved | Click Save on Manage Widget before testing. |
| Browser cache | Hard-refresh your site (Ctrl+Shift+R / Cmd+Shift+R). |
| Wrong App ID | Confirm data-app-id matches the app you edited. |
Dashboard shows zeros
| Cause | Fix |
|---|---|
| No apps yet | Create an app first. |
| No submissions | Submit test feedback via the widget. |
| Wrong app filter | Set the header filter to All apps. |
Private key lost after app create
The plaintext key is shown once in the create modal. If you missed it:
- Open Apps → Manage → API credentials
- Create a new private server key with the required scopes
- Revoke the lost key
Widget validation errors
Errors appear inside the widget panel when:
- Email format is invalid
- A required rating or description is missing
- Screenshot is too large (max 5 MB) or not an image file
Still stuck?
- Confirm your embed snippet matches Manage Widget → Embed
- Submit a test from your live site and check the browser Network tab for failed requests
- See FAQ or contact support via the TellTide site