Skip to content

Documentation

How to Add a Cookie Banner on an Astro Website

How to Add a Cookie Banner on an Astro Website

Last updated Mar 15, 2026

This guide shows you how to add the Kukie.io cookie consent banner to your Astro website. Astro uses layout components where you can add the script directly.

Prerequisite: You need a Kukie.io account and at least one site added. If you haven't done this yet, follow Create Your Account & Add Your First Site first.

Step 1: Get Your Embed Code

Log in to your Kukie.io dashboard, navigate to your site, and copy the embed code from the Setup tab. It looks like this:

<script src="https://cdn.kukie.io/s/YOUR-SITE-KEY/c.js" async></script>

Replace YOUR-SITE-KEY with the actual site key shown in your dashboard.

Step 2: Add the Script to Astro

Open your base layout file (usually src/layouts/Layout.astro) and add the script inside the <head>:

---
// src/layouts/Layout.astro
---
<html lang="en">
<head>
    <meta charset="UTF-8" />
    <script is:inline src="https://cdn.kukie.io/s/YOUR-SITE-KEY/c.js" async></script>
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <slot name="head" />
</head>
<body>
    <slot />
</body>
</html>

The is:inline directive tells Astro to include the script tag as-is in the HTML output, without bundling or processing it. This is required for external scripts.

Step 3: Verify the Installation

Visit your website in a new browser window (or incognito/private mode). You should see the Kukie.io consent banner appear. If it does not show, check the following:

  • Open your browser's Developer Tools (F12) and look for the script in the Network tab — it should load with a 200 status
  • Check the Console tab for any JavaScript errors
  • Make sure you published/saved your changes in your Astro site
  • Clear any platform-level cache if applicable

For a detailed verification walkthrough, see How to Verify Your Banner Installation.

Next Steps

Need help? If you run into any issues, contact our support team and we'll help you get set up.

Previous

How to Add a Cookie Banner on a PrestaShop Website
Next

How to Add a Cookie Banner on a Hugo Website
Was this helpful?