---
title: "Troubleshooting"
description: "Troubleshoot Tracwell collection, validation, identity, routing, and delivery."
documentation: "https://tracwell.app/docs/troubleshooting"
markdown: "https://tracwell.app/docs/troubleshooting.md"
---

# Troubleshooting

> Troubleshoot Tracwell collection, validation, identity, routing, and delivery.

## 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 `onError` to inspect the SDK 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.