📦 docusaurus-plugin-umami

Umami Analytics plugin for Docusaurus v2.

⚠️ production only

This plugin is always inactive in development and only active in production to avoid polluting the analytics statistics.

Installation

Install the plugin with npm:

npm install --save @dipakparmar/docusaurus-plugin-umami

or with yarn:

yarn add @dipakparmar/docusaurus-plugin-umami

or with pnpm:

pnpm install @dipakparmar/docusaurus-plugin-umami

or with bun:

bun install @dipakparmar/docusaurus-plugin-umami

Configuration

Add the plugin and websiteID and analyticsDomain to your docusaurus.config.js:

module.exports = {
  plugins: [
    [
      "@dipakparmar/docusaurus-plugin-umami",
      /** @type {import('@dipakparmar/docusaurus-plugin-umami').Options} */
      ({
        websiteID: "your-website-id", // Required
        analyticsDomain: "analytics.mydomain.com", // Required
        scriptName: "", // Optional
        dataHostURL: "", // Optional
        dataAutoTrack: true, // Optional
        dataDoNotTrack: true, // Optional
        dataCache: true, // Optional
        dataDomains: "", // comma separated list of domains, *Recommended*
      }),
    ],
  ],
};

Options

Accepted fields:

Name	Type	Default	Description
websiteID	string	Required	The unique website ID from your Umami Analytics.
analyticsDomain	string	Required	Your domain of where Umami Analytics is hosted.
scriptName	string	script.js	Name of your custom tracker script.
dataHostURL	string		By default, Umami will send data to wherever the script is located. You can override this to send data to another location.
dataAutoTrack	boolean		By default, Umami tracks all pageviews and events for you automatically. You can disable this behavior and track events yourself using the tracker functions.
dataDoNotTrack	boolean		Configure Umami to respect the visitor's Do Not Track setting.
dataCache	boolean		If you get a lot of pageviews from the same user, for example in a forum website, you can cache some data to improve the performance of the tracking script.
dataDomains	string		If you want the tracker to only run on specific domains, you can add them to your tracker script. This is a comma delimited list of domain names. Helps if you are working in a staging/development environment.
dataExcludeSearch	boolean	false	Configure the tracker to not record query parameters.

Reference:

• Docusuarus Plugin Readme Example from https://github.com/sgromkov/docusaurus-plugin-yandex-metrica
• Plugin Architecture: https://docusaurus.io/docs/api/plugin-methods#example
• Umami Analytics Tracker Configuration: https://umami.is/docs/tracker-configuration