Integration

PostHog

Confirms analytics script loading and CSP compatibility.

Product analytics gaps at launch mean you fly blind on activation and conversion—often because the snippet never loaded, the project key is wrong, or Content Security Policy blocks capture requests. PreFlight checks script reachability, landing-page install, and CSP rules before you rely on PostHog dashboards on day one.

Requirements

<IntegrationRequirements items={[ "PostHog project API key", "PostHog host or reverse-proxy URL", "Public landing page URL where the snippet should be installed", ]} />

What PreFlight checks

| Probe | What it proves | | --- | --- | | Script reachability | The PostHog script endpoint responds and is loadable. | | Landing page install | The configured project key appears on the public landing page. | | CSP compatibility | Content Security Policy allows PostHog in `script-src` and `connect-src`. | | Host alignment | The host in your config matches what the snippet requests at runtime. |

Failure guidance

| Symptom | Fix | | --- | --- | | Script not found on page | Install the PostHog snippet on the public landing page with the correct project key. | | CSP blocked | Allow the PostHog host in `script-src` and `connect-src` at your CDN or framework layer. | | Wrong project key | Copy the key from PostHog → Project Settings and redeploy. | | Reverse proxy mismatch | Confirm the proxy URL in PreFlight matches the `api_host` in your client init. |

Dashboard setup

Go to Integrations → PostHog in your PreFlight project. Paste the project API key and PostHog host (or proxy URL). Enter the public landing page URL where analytics should be active. Run Pre-Flight Check and resolve any CSP or install warnings.

<RelatedLinks links={[ { href: "/docs/integrations/privacy-analytics", title: "Privacy Analytics", description: "Plausible or Umami collector readiness checks." }, { href: "/docs/integrations/environment", title: "Environment", description: "Security headers and CSP baseline on your public URL." }, { href: "https://posthog.com/docs", title: "PostHog documentation", description: "Snippet install, CSP, and reverse proxy guides." }, ]} />