Configuration reference

Before the first Settings save, server configuration supplies non-secret values; afterward, Umbraco settings take precedence.

The Settings screen is the normal way to manage connections.

Configuration lifecycle and precedence

Before an administrator first saves Settings → Web Analytics, server configuration supplies the active non-secret values. After that first save, Umbraco-stored non-secret connection settings become the source of truth.

1. At startup, the package reads WebAnalytics server configuration.
2. Until an administrator saves Settings → Web Analytics, those non-secret values are the active configuration.
3. After the first settings save, non-secret connection settings are stored in Umbraco and become the source of truth.
4. Provider credentials always remain in server-side configuration. A connection-specific credential overrides the shared provider credential.

Each Umbraco application instance keeps its own in-memory report cache. Restart every instance after changing saved settings or credentials so every process uses the same configuration.

Safe configuration-only example

Use configuration-only setup when deployment automation must bootstrap connections. Do not put access tokens in this file.

{
  "WebAnalytics": {
    "Enabled": true,
    "DefaultRangeDays": 30,
    "CacheDuration": "00:05:00",
    "Connections": [
      {
        "Key": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "Provider": "Vercel",
        "ProjectId": "prj_...",
        "Team": "team_...",
        "DocumentRootKeys": [
          "11111111-1111-1111-1111-111111111111"
        ],
        "EnableAllDocumentTypes": false,
        "EnabledDocumentTypeKeys": [
          "22222222-2222-2222-2222-222222222222"
        ]
      }
    ]
  }
}

For Plausible, use "Provider": "Plausible" and set SiteId instead of ProjectId and Team. Add EventPropertyNames for custom event properties.

Package settings

Connection settings