New: version 0.0.99 is available. Read the release notes.

Bark
On this page
This is an older version of the docs. View the latest

Extensions

Extensions are built-in integrations configured in extensions.json. Bark injects the script, updates the Content Security Policy, and applies changes through hot reload. Available extensions are privacy-focused analytics providers.

What's Supported ​

Extension Type Required keys
Matomo Analytics, self-hosted url, siteId
Plausible Analytics, hosted or self-hosted domain
Medama Analytics, self-hosted url
GoatCounter Analytics, hosted or self-hosted url
Liwan Analytics, self-hosted url, entity

How Extensions Work ​

Extensions are configured in the optional docs/extensions.json, next to config.json.

json
{
  "extensions": {
    "plausible": {
      "enabled": true,
      "domain": "docs.example.com"
    }
  }
}

Extensions are disabled unless enabled is true. An empty or absent file disables all extensions. Changes apply through hot reload.

Each enabled extension is validated. An invalid configuration leaves the extension inactive and logs a warning at startup.

INFO

The Content Security Policy is extended with the configured origin, and each injected script carries the page nonce. A strict CSP remains compatible.

Available Extensions ​

Multiple extensions can run simultaneously.

Matomo ​

Matomo: self-hosted analytics. Cookieless mode is enabled by default.

json
{
  "extensions": {
    "matomo": {
      "enabled": true,
      "url": "https://analytics.example.com",
      "siteId": "1",
      "disableCookies": true
    }
  }
}
Field Description
enabled true activates the extension.
url Matomo base URL.
siteId Numeric Matomo site ID. site_id is also accepted.
disableCookies Cookieless tracking. Default: true.

Plausible ​

Plausible: cookie-free analytics, hosted or self-hosted.

json
{
  "extensions": {
    "plausible": {
      "enabled": true,
      "domain": "docs.example.com",
      "url": "https://plausible.io",
      "script": "script.js"
    }
  }
}
Field Description
enabled true activates the extension.
domain Site domain registered in Plausible. Comma-separated for a shared script.
url Base URL. Default: https://plausible.io; required only when self-hosting.
script Script variant under /js/, such as script.outbound-links.js. Default: script.js.

Medama ​

Medama: self-hosted analytics.

json
{
  "extensions": {
    "medama": {
      "enabled": true,
      "url": "https://medama.example.com"
    }
  }
}
Field Description
enabled true activates the extension.
url Medama base URL.

GoatCounter ​

GoatCounter: analytics, free hosted or self-hosted.

json
{
  "extensions": {
    "goatcounter": {
      "enabled": true,
      "url": "https://you.goatcounter.com"
    }
  }
}
Field Description
enabled true activates the extension.
url GoatCounter site base URL.

Liwan ​

Liwan: self-hosted analytics with single-file storage.

json
{
  "extensions": {
    "liwan": {
      "enabled": true,
      "url": "https://liwan.example.com",
      "entity": "my-website"
    }
  }
}
Field Description
enabled true activates the extension.
url Liwan base URL.
entity Liwan entity ID for this site.

A Complete Example ​

Template with all five providers disabled:

json
{
  "extensions": {
    "matomo": {
      "enabled": false,
      "url": "https://analytics.example.com",
      "siteId": "1",
      "disableCookies": true
    },
    "plausible": {
      "enabled": false,
      "domain": "example.com",
      "url": "https://plausible.io",
      "script": "script.js"
    },
    "medama": {
      "enabled": false,
      "url": "https://medama.example.com"
    },
    "goatcounter": {
      "enabled": false,
      "url": "https://you.goatcounter.com"
    },
    "liwan": {
      "enabled": false,
      "url": "https://liwan.example.com",
      "entity": "my-website"
    }
  }
}

An enabled extension injects its script into <head> with the page nonce. Related: Site Config.

Edit this page on GitHub
Last updated: 2026-10-08