Plausible
Plausible Cloud and self-hosted connection fields, endpoint requirements, event properties, capabilities, and common errors.
The quickstart covers first-time setup. This page is for looking up Plausible-specific requirements, fields, and capabilities.
About Plausible
Plausible is an open-source analytics platform, run either as a hosted service or on your own instance. This package reads what Plausible has already collected and shows it 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. On Plausible Cloud, the Stats API requires a Business plan.
A self-hosted instance works as long as it exposes the v2 Stats API query endpoint. Its public base URL must use HTTP or HTTPS and cannot carry user information, a query, or a fragment. The Umbraco application must be able to reach /api/v2/query there.
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. For connection errors such as 401, 403, a rejected query, or self-hosted endpoint issues, see Plausible troubleshooting.
Event properties
Add custom event-property names when the site records properties beyond Plausible’s built-in fields. Up to 20 names, each at most 100 characters.
| Property | Built in for |
|---|---|
url |
Outbound-link and file-download goals |
path |
404 goals |
Capabilities
Plausible connections report core totals, history, traffic breakdowns, UTM dimensions, event lists, event-property drill-downs, global event and event-property filtering, and selectable breakdown ordering.
Plausible has no feature flags, so the backoffice hides that panel on a Plausible connection.