Analytics & Traffic Tracking

Understand your audience and grow your site with integrated analytics. HugoBlox supports privacy-focused options like Pirsch and Fathom, as well as industry standards like Google Analytics.

Providers

Privacy First
Traditional

Pirsch

Recommended. Privacy-first, lightweight, and best value. No cookie banner required. Get Pirsch

Fathom

Simple, privacy-focused analytics. No cookie banner required. Get Fathom

Plausible

Open source, privacy-friendly analytics. No cookie banner required. Get Plausible

Configuration

Add your tracking ID to config/_default/params.yaml:

hugoblox:
  analytics:
    pirsch:
      site_id: 'YOUR_SITE_ID'

hugoblox:
  analytics:
    fathom:
      site_id: 'YOUR_SITE_ID'

hugoblox:
  analytics:
    plausible:
      domain: 'yoursite.com'

hugoblox:
  analytics:
    google:
      measurement_id: 'G-XXXXXXXXXX'

hugoblox:
  analytics:
    google_tag_manager:
      container_id: 'GTM-XXXXXXX'

hugoblox:
  analytics:
    clarity:
      project_id: 'YOUR_PROJECT_ID'

hugoblox:
  analytics:
    baidu: 'YOUR_TONGJI_ID'

Microsoft Clarity:

hugoblox:
  analytics:
    clarity:
      project_id: 'YOUR_PROJECT_ID'

PostHog / Umami / Others: For other providers, use the Custom Hooks feature to inject their tracking script into the <head> or <body>.

Troubleshooting

Check Environment: Ensure your site is deployed or running in production mode (HUGO_ENV=production hugo server).
Verify ID: Double-check that your tracking ID matches the one in your analytics dashboard.
Ad Blockers: If you don’t see data, check if your ad blocker is preventing the script from loading.