Documentation

Widget installation

Install the Notion Analytics tracking widget and verify events.

1 min read/9 sections

Use the widget route for your workspace, embed it on the pages you want to track, and verify events in the realtime dashboard.

Connect Notion first

Start from onboarding and connect the Notion workspace with OAuth. The workspace record gives the tracker a real database parent, and the Notion connection lets the product discover pages that can be selected for tracking.

Select pages to track

Choose public docs, client portals, template pages, internal knowledge bases, or course pages that need analytics. Each tracked page gets a stable page record, widget state, slug, and workspace ownership check.

Use the generated widget URL in a Notion embed block. Where the Notion API has permission, auto-embed can place the tracker for you. If permission is limited, copy the widget URL and install it manually on the target page.

Verify realtime events

Open the realtime dashboard after installing the widget. A successful setup shows incoming views, sessions, referrers, and page activity. If the report stays empty, confirm the widget ID, page permissions, browser blocking, and Supabase configuration.

Share on X Share on LinkedIn Copy link

Was this helpful?

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

API keys and webhook signatures

Create scoped API keys, call workspace endpoints, and verify signed webhook deliveries.

Scheduled reports

Configure recurring email, CSV, and PDF analytics delivery for stakeholders.

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.