No events

Every browser and server event goes to https://ingest.datalyr.com, and the status on that request names the failure. Start there before you change any code.

Read the status first

Open devtools, select the Network tab, and reload the page. Filter on ingest.

Status	Body	Cause	Fix
`200`	`processed: N`	We accepted the batch	Look in Events
`200`	`Events dropped - workspace no longer exists`	The workspace ID is wrong or deleted	Recopy it from Settings → Tracking → Install
`200`	`All events were duplicates`	The same `event_id` arrived inside 7 days	Send a unique `event_id`
`204`	empty	Your IP is on the blocked list	Remove it under Settings → Filters
`400`	`workspace_id is required`	The snippet carries no workspace ID	Add `data-workspace-id` to the tag
`400`	`Invalid JSON body`	The payload is malformed	Fix the sending code
`400`	`Invalid event(s): missing required fields`	Every event lacks one of four fields	Send `workspace_id`, `event_name`, `event_id`, `visitor_id`
`401`	`API key required for server-side requests`	No browser `Origin` and no API key	Add an `Authorization: Bearer` header
`403`	`Origin not allowed for this workspace`	Your workspace enforces an allow-list	Add the hostname under Settings → Filters
`405`	`Method not allowed`	A `GET` reached the endpoint	Send `POST`
`413`	`Payload too large`	Over 1 MB	Send fewer properties per batch
`415`	`Unsupported Media Type`	`Content-Type` is not `application/json`	Set the header
`429`	`Rate limit exceeded. Please try again later.`	Over 10,000 events per minute for this workspace	Honour `Retry-After: 60`
No request	none	The script never ran	Read the next section

The SDK treats any 4xx except 408 as permanent, so it drops that batch instead of retrying. Fix the cause above, then send the event again.

Server SDK statuses on `/track`

Status	Body	Fix
`401`	`Missing API key. Please provide X-API-Key header or Authorization Bearer token.`	Add the header
`401`	`Invalid API key`	Mint a new key under Settings → API
`413`	`Payload too large. Maximum size is 256KB.`	Send fewer properties
`429`	`Rate limit exceeded. Maximum 1000 requests per second.`	Honour `Retry-After: 1`
`400`	`Request body is required`	Send a JSON body
`400`	`Event name is required (event or event_name field)`	Pass `event` or `event_name`
`400`	`Identity required: provide distinct_id, user_id, anonymous_id, or visitor_id`	Pass one of the four
`200`	`Duplicate event detected`	Send a unique `event_id`

No request leaves the browser

Run these four in the console on the page you are testing.

typeof window.datalyr          // "object"
window.datalyr.initialized     // true
window.datalyr.getWorkspaceId()// your public workspace ID
window.datalyr.getErrors()     // the last 50 SDK errors

Result	Cause	Fix
`"undefined"`	An ad blocker stopped the script	Retest with blockers off
`"undefined"`	The tag is absent from the HTML	Confirm it in View source
`initialized` is `false`	The tag has no `data-workspace-id`	The console logs `Datalyr Error: data-workspace-id attribute is required on the script tag.`
`getWorkspaceId()` returns another ID	A second tag booted another workspace	The console logs `[Datalyr] Replaced an existing SDK configured for another workspace.`

The SDK loaded but sends nothing

Tracking stops in five cases. Run window.datalyr.isOptedOut() first.

Cause	Default	How to confirm
Your browser sends Global Privacy Control	Datalyr honours it	Turn GPC off and retest
Your app called `optOut()`	n/a	`isOptedOut()` returns `true`
Your app called `setConsent({ analytics: false })`	n/a	Grant analytics consent
A Shopify storefront has unresolved consent	Datalyr waits, then declines	Accept the consent banner
The path is on the blocked-pages list	n/a	Check Settings → Filters

Do Not Track is off by default, so a DNT browser is tracked.

An ad blocker stops requests to ingest.datalyr.com for real visitors, not only for you. Set up first-party tracking so the requests go to your own hostname.

Server and mobile SDKs send nothing

The SDK batches. It sends after 10 events or 5 seconds, whichever comes first. It retries 5 times and queues 100 events offline.

Call flush() before a serverless function returns. The process exits before the 5-second timer fires, and the batch never leaves.

Verify

Open Live.
Reload the page you are testing.
Confirm your visitor appears within 30 seconds.

If Live stays at watching for events, contact support. Send the workspace public ID, the X-DL-SDK-Version header value, and the status code.

Get started

Installation

Revenue

Using Datalyr

Advanced

Integrations

Account & billing

Troubleshooting

Read the status first

Server SDK statuses on `/track`

No request leaves the browser

The SDK loaded but sends nothing

Server and mobile SDKs send nothing

Verify

​Read the status first

​Server SDK statuses on /track

​No request leaves the browser

​The SDK loaded but sends nothing

​Server and mobile SDKs send nothing

​Verify

Read the status first

Server SDK statuses on `/track`

No request leaves the browser

The SDK loaded but sends nothing

Server and mobile SDKs send nothing

Verify