Help Center

Tracking troubleshooting

Resolve missing events, OAuth issues, and page permission errors.

1 min read/9 sections

Check the widget ID, page permissions, browser console, Supabase configuration, and ingestion route response before escalating.

Confirm the page is tracked

Open the tracked pages list and confirm the Notion page appears under the correct workspace. If the page is missing, reconnect Notion or add it during onboarding before testing the widget.

Check the embed block

The Notion page must contain the generated widget URL in an embed block. If the block was copied from another workspace or page, replace it with the correct widget URL from Widget Studio.

Test a clean visit

Open the page in a fresh browser session and watch the realtime report. Browser privacy tools, blocked third-party requests, or stale embeds can prevent a test visit from appearing immediately.

Escalate with useful details

If tracking still fails, include the workspace name, page URL, widget ID, browser, expected event, and the time of the test visit when contacting support.

Share on X Share on LinkedIn Copy link

Was this helpful?

Feedback is stored anonymously so documentation can improve with real reader signals.

Billing and plan troubleshooting

Resolve checkout, customer portal, invoice, trial, dunning, and plan-limit issues.

Team permissions troubleshooting

Fix member invites, role access, seat limits, and workspace permission issues.

Operational guidance

Use this resource alongside the dashboard, widget studio, API settings, and onboarding flow to keep the analytics setup accurate as your Notion workspace changes.