astro-umami

An Astro integration to add Umami Analytics to your website.

🪶 Highlights

• Automatically detects if you’re using View Transitions and adds a data-astro-rerun attribute
• Disables events and pageviews during development
• Prevents Google Tag Manager from stripping custom data-* attributes
• Supports all configuration options, unlike astro-analytics
• (Optionally) Serve the tracking script using Partytown (planned in an upcoming release)
• Actively maintained (Astro 5 ready)

🛟 Usage

Install

Enable Umami analytics in your Astro project with the following:

pnpm astro add @yeskunall/astro-umami

This will install @yeskunall/astro-umami and make the appropriate changes to your Astro config automatically.

Manual install

1. Install the required dependencies

pnpm add @yeskunall/astro-umami

2. Add the integration to your Astro config:

+ import umami from "@yeskunall/astro-umami";

export default defineConfig({
  integrations: [
+    umami({ id: "94db1cb1-74f4-4a40-ad6c-962362670409" }),
  ],
});

📖 For all configurable options, see the exported interface.

---

⚖️ License

MIT © Kunall Banerjee