Browse documentation

Troubleshooting

Check configuration, consent, delivery, and routing behavior when expected analytics do not appear.

Common issues

Checks
No events
Check the project key, exact registered origin, consent, Do Not Track, and the response from collect.tracwell.app/v1/events.
Invalid event
Use the onError callback to inspect the error code and contract issues.
Identify blocked
identify() is available only in Product mode.
Duplicate pages
Let automatic tracking handle normal History API routes. Call page() only for navigation it cannot observe.
Delayed events
Events use small batches. Call await analytics.flush() to hand off queued events immediately.