# Analytics Add analytics to your site by editing `settings/analytics.md`. Supports Google Analytics, Plausible, Fathom, Umami, Simple Analytics, PostHog, and Matomo out of the box — or paste any custom script. ## Quick setup Set the provider in `settings/analytics.md` and configure your tracking ID using the CLI: ```yaml # settings/analytics.md --- provider: plausible --- ``` ``` sitemd config set analytics.id yourdomain.com ``` Or use the interactive setup to configure everything at once: ``` sitemd config setup analytics ``` The build system injects the correct script tag into `` on every page. Tracking IDs and pixels are stored in `.sitemd/config.json` (gitignored), not in your settings files. See [CLI Config](/docs/cli-config) for details. ## Supported providers | Provider | `provider` value | `id` value | `host` needed? | |---|---|---|---| | Google Analytics 4 | `google` | Measurement ID (`G-XXXXXXXXXX`) | No | | Plausible | `plausible` | Your domain (`example.com`) | No | | Fathom | `fathom` | Site ID | No | | Umami | `umami` | Website ID | Yes, if self-hosted | | Simple Analytics | `simpleanalytics` | Your domain | No | | PostHog | `posthog` | API key | Yes, if self-hosted | | Matomo | `matomo` | Site ID | Yes | ## Self-hosted providers For self-hosted instances of Umami, PostHog, or Matomo, also set the `host`: ``` sitemd config set analytics.id a1b2c3d4-5678-90ab-cdef-1234567890ab sitemd config set analytics.host https://analytics.yourdomain.com ``` ## Ad tracking pixels Add conversion tracking pixels for ad platforms using the CLI: ``` sitemd config set analytics.pixels '[{"meta":"1234567890"},{"google-ads":"AW-123456789"}]' ``` Each pixel injects the platform's official base code into `` on every page. Supported platforms: | Platform | Key | ID value | |---|---|---| | Meta (Facebook) Pixel | `meta` | Pixel ID (numeric) | | Google Ads | `google-ads` | Conversion ID (`AW-XXXXXXXXX`) | | LinkedIn Insight Tag | `linkedin` | Partner ID (numeric) | | TikTok Pixel | `tiktok` | Pixel ID | If you're using `provider: google` for analytics, the Google Ads pixel shares the same gtag.js loader — no duplicate scripts. You can combine analytics, pixels, and GTM in the same file. Use as many or as few as you need. ## Google Tag Manager For teams that manage all tracking through GTM: ``` sitemd config set analytics.gtm GTM-XXXXXXX ``` This injects the GTM container script in `` and the required `