Use this checklist when the Userorbit SDK does not load, identify a contact, track events, or display an experience.

SDK does not load

Confirm the current snippet or userorbit-js package, the correct Account ID, and CSP access to the configured CDN and API. Check the first failed Network request.

Contact does not appear

Wait for init() to finish, then call identify(userId, options). Confirm the user is sent to the expected workspace and search Contacts by email or user ID.

Experience does not appear

Confirm it is published, its URL rule matches, the contact matches its segment, and required page elements exist. Test with frequency and dismiss state reset.

SPA navigation

Automatic detection covers common History API, Next.js, hash, and popstate changes. Call registerRouteChange() after navigation as a fallback.

Useful support details

Include SDK version, framework, browser, page URL pattern, redacted init options, and the failed request status.

Was this helpful?