What does this plugin do?

This plugin adds a privacy-first cookie consent banner to Astro sites, allowing visitors to control analytics and marketing cookies before any tracking scripts are loaded.

Does it load analytics or tracking scripts automatically?

No. Nothing is loaded automatically. You decide when analytics or marketing scripts run, based entirely on user consent.

Is this suitable for GDPR and UK GDPR?

Yes. The plugin is designed to ensure no non-essential cookies or scripts are loaded before explicit user consent is given.

Yes. The plugin is fully open source and free to use.

Astro plugin

Cookie Consent for Astro

A privacy-first cookie consent solution for Astro — fully customisable, zero default styling, and complete control over when analytics and marketing scripts run.

Modern privacy regulations require explicit user consent before loading analytics, marketing scripts, or setting non-essential cookies.

This plugin provides a clean, developer-controlled consent flow without dashboards, third-party services, or opinionated design. You control the visuals, behaviour, and integrations.

What this plugin does

Displays a cookie consent banner with an optional preferences modal
Prevents analytics and marketing scripts from loading before consent
Exposes a simple JavaScript consent API
Provides full CSS control with no enforced design
Stores consent locally with automatic expiry

Installation

Installation happens in two simple steps. The plugin includes a small installer that configures everything automatically.

npm install astro-consent

npx astro-consent

Adds the consent integration to astro.config
Creates a fully editable src/cookiebanner.css file
Ensures no non-essential scripts run before consent

The generated CSS file is never overwritten, giving you full control over layout, spacing, and visual design.

Project links

Source code, releases, documentation, and contribution guidelines.

npm package GitHub repository

Learn more about cookie consent

Understand how consent is stored, how the API works, and how to safely integrate analytics and marketing scripts.

Plugin FAQs