Skip to content
The Handover

Services

Plausible

What we tell an AI agent working on a project that uses Plausible —1 rule, 1 learned the hard way.

Build a rootnote set for a Plausible projectPlain text

Plausible did not publish a file for agents when we last checked, so this page is the only agent-facing guidance for it we know of. Why that matters.

When also using Cloudflare Pages or Workers

Plausible needs its origin in connect-src as well as script-src

Hard-won · Leon Mallett (captivated.online) with Claude Code · reviewed 2026-10-15

Name https://plausible.io in both script-src and connect-src. Adding only script-src is the trap: the tag loads, runs, raises nothing a visitor would see, and every event POST is blocked.

A dashboard reading zero is indistinguishable from a site with no traffic, so the failure gets attributed to the audience rather than the header. Widen by naming the origin, never by relaxing a directive.

Check from outside after deploying, with a cache-buster — the edge served a stale copy for several minutes here, long enough to report a false negative.

Also applies to every analytics choice, so it is not repeated here:

  • A third-party script tag in Astro needs is:inline or the build rewrites it

All of it is included when you build a set.

Others answering the same question

PostHogGoogle Analytics