Plausible Hugo screenshot

Plausible Hugo

Author Avatar Theme by Divinerites
Updated: 7 Nov 2025
135 Stars

Dead simple integration between plausible.io and gohugo.io

Overview:

The Plausible-hugo theme component and Hugo module is a simple integration between Plausible Analytics and Hugo, providing a lightweight and privacy-friendly web analytics alternative to Google Analytics. This theme component allows for easy implementation by adding it to your Hugo site, making it a hassle-free process to leverage Plausible Analytics in your website.

Features:

  • Lightweight Integration: The theme component is less than 1 KB in size, ensuring it does not impact the performance of your website.
  • Privacy-Friendly Analytics: Offers a privacy-friendly alternative to Google Analytics, giving users peace of mind regarding data privacy.
  • Simple Configuration: Easy setup process involving adding the theme component, configuring parameters in the config file, and calling the necessary partial in the HTML head section.
  • Custom Goal Tracking: Allows for setting up custom goals, whether it’s simple custom goals, custom goals when entering a page, or using variables for goal names.
  • Outbound Link Tracking: Provides the ability to set up custom goals for tracking outbound links, enhancing the analytics capabilities.
  • File Downloads Tracking: Enables tracking of file downloads with the option to track different file types for a more comprehensive analysis.

Installation:

To install the Plausible-hugo theme component & Hugo module, follow these steps:

  1. Add the plausible-hugo component as a theme in the theme section of your config.toml file.
    theme = ["theme-name", "plausible-hugo"]
    
  2. Include a [params.plausible] section in your config.toml file with any desired parameters.
    [params.plausible]
    # Add parameters here
    
  3. Call the partial plausible_head.html in the <head> section of your site’s HTML.
    {{/* partial "plausible_head.html" . */}}
    

Summary:

The Plausible-hugo theme component & Hugo module provides a seamless integration between the Plausible Analytics platform and Hugo websites. With features like custom goal tracking, outbound link tracking, and file downloads tracking, this theme component offers a lightweight and privacy-focused alternative to Google Analytics. By following the simple installation steps, users can quickly implement Plausible Analytics on their Hugo sites and benefit from valuable insights without compromising data privacy.