Skip to main content

Common Errors

Quick reference for error messages you may encounter.

SDK Errors​

ErrorCauseSolution
told is not definedSDK script not loadedVerify the script tag is in your <head> (installation guide)
Invalid hostnameSource URL doesn't match current domainUpdate the URL in Source settings to match your website domain
Source not foundIncorrect Source IDVerify the Source ID in your told('init', ...) call
CSP violationContent Security Policy blocking ToldConfigure CSP to allow Told domains

Survey Errors​

ErrorCauseSolution
Survey not showingMultiple possible causesFollow the survey troubleshooting checklist
"Response limit reached"Monthly plan limit exceededUpgrade your plan or wait for the next billing period

Webhook Errors​

ErrorCauseSolution
Webhook not deliveredEndpoint unreachable or returns errorVerify URL, check endpoint logs, ensure HTTPS
Unexpected payloadWrong event type selectedCheck the event type in webhook configuration

Mobile SDK Errors​

ErrorCauseSolution
Init crashMissing or incorrect configurationVerify all ToldConfiguration parameters
Screens not trackedNavigation not registeredCall registerNavController or registerActivityCallback (Android), activateAutomaticScreenTracking (iOS)

Need more help?​

If your error isn't listed here:

  1. Run told('debug') (web) or Told.debugWidget() (mobile) for diagnostic info
  2. Contact [email protected] with the debug output
  3. Join our Slack community