Plausible
Reference for Plausible Cloud and self-hosted connections, including fields, endpoint requirements, event properties, reports, and common errors.
The quickstart owns the first-time setup flow. Use this page to look up Plausible-specific requirements, connection fields, and capabilities.
About Plausible
Plausible is a privacy-friendly, open-source web analytics platform available as a hosted service or self-hosted instance. This package reads the reports Plausible already collects and makes them available in Umbraco; it does not add tracking to the public site.
Cloud and self-hosted requirements
The connection needs a Plausible Stats API key in server-side configuration. Plausible Cloud’s Stats API requires a Business plan.
Self-hosted Plausible is supported when the instance exposes the v2 Stats API query endpoint. Its public base URL must use HTTP or HTTPS and cannot include user information, a query, or a fragment. The Umbraco application must be able to reach its /api/v2/query endpoint.
Connection fields
| Field | Value |
|---|---|
| Credential setting | WebAnalytics__Providers__Plausible__AccessToken |
| Site ID | The registered site ID, normally the domain, matching Plausible exactly |
| Self-hosted base URL | WebAnalytics__Providers__Plausible__BaseUrl=https://analytics.example.com/; Cloud users keep the default https://plausible.io/ |
Add these values in Settings → Web Analytics. A 401 or 403 usually means the Stats API key cannot read that site; a rejected query commonly means the Site ID does not match the registered domain.
Event properties
Add custom event-property names when the site records properties beyond Plausible’s built-in fields. You can configure up to 20 names, each with at most 100 characters.
| Property | Built in for |
|---|---|
url |
Outbound-link and file-download goals |
path |
404 goals |
Capabilities
Plausible connections provide core totals, history, traffic breakdowns, UTM dimensions, event lists, event-property drill-downs, global event and event-property filtering, and selectable breakdown ordering.
Plausible does not expose Vercel feature flags, so the flags panel is hidden for this provider.