---
title: Plausible
description: Reference for Plausible Cloud and self-hosted connections, including fields, endpoint requirements, event properties, reports, and common errors.
seo:
  image: /og/providers/plausible.png
---

The [quickstart](/quickstart) owns the first-time setup flow. Use this page to look up Plausible-specific requirements, connection fields, and capabilities.

## About Plausible

[Plausible](https://plausible.io/) 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](https://plausible.io/docs/stats-api) 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**. For connection errors such as `401`, `403`, a rejected query, or self-hosted endpoint issues, see [Plausible troubleshooting](/reference/troubleshooting#plausible).

## 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.