---
title: Add a cookie consent banner to a Hugo site
description: Put the Cookie Compliance snippet first in the head partial your layouts render on every page, above the analytics tags, so the banner can hold them until the visitor chooses.
kind: platform
last_verified: 2026-11-12
---

# Add a cookie consent banner to a Hugo site

**In short:** paste the **live** snippet as the first thing in the `<head>` your layouts render on every page: `layouts/_default/baseof.html`, or the head partial it includes, above your analytics tag.

Confirmed on a Hugo site with its own `baseof.html` and head partial: the snippet is the first script in the built page's `<head>`.

## You need

- A Cookie Compliance AppID and the live snippet from MCP `install.getSnippet` or dashboard **Integrations → Manual Integration** (a new app uses `/v2/hu-banner.min.js`; an existing app keeps the URL in that snippet). A domain added in the dashboard is published automatically; if the status check still says the app is not published yet, or after later edits, click **Publish Now**, then copy the snippet. A snippet copied before publishing must be copied again. No account yet? [Sign up](https://app.hu-manity.co/#/register?enable-free=true&discount=JOIN-40D&utm_source=agent-manual&utm_medium=docs&utm_content=cookbook-hugo) (free plan, no card); with MCP, call `help.startSignup`.
- Edit access to the site's `layouts/` folder (the template that renders `<head>`).

## Where it goes

1. Copy the live snippet (see above).
2. Open the template that renders `<head>` for every page: `layouts/_default/baseof.html`, or the head partial it calls.
3. Paste the snippet as the **first script**, before your analytics and any theme scripts:

   ```go-html-template
   <head>
     <meta charset="utf-8">
     <title>{{ .Title }}</title>
     <!-- Cookie Compliance: first script on the page (paste live snippet here) -->
     <script>
         var huOptions = { "appID": "YOUR_APP_ID", "currentLanguage": "en", "blocking": true, "globalCookie": false };
     </script>
     <script src="https://cdn.hu-manity.co/v2/hu-banner.min.js" type="text/javascript" charset="utf-8"></script>

     <!-- your existing tags stay below it -->
     <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXX"></script>
   </head>
   ```

4. Rebuild with `hugo`. Your trackers stay as they are; the banner manages them.

If the snippet currently sits in a footer partial, or in a partial rendered after your analytics tag, move it up to the top of the head partial.

## What the order controls

The banner holds recognised trackers that load after it until the visitor chooses, in regions whose rule requires consent first. A script placed above the snippet runs straight away, and a script you mark `data-hu-category="1"` is treated as essential. What runs before consent is your decision, so keep analytics and pixels below the snippet.

## Confirm the result

Build or render the site, then **view the page source** of the output (not the browser's Elements panel): the `huOptions` script and `hu-banner.min.js` are the first two `<script>` tags in `<head>` of `public/index.html`, with no `async` or `defer`, and your analytics tag comes after them.

Then run the browser checks in [plain-html](plain-html.md#confirm-the-result) in a private window (banner shows, no tracking cookies before the visitor chooses in a region whose rule requires consent first, trackers start after Allow) and, for the full procedure, [verify-install](https://manual.hu-manity.co/skills/verify-install/SKILL.md). Test from a region your strictest rule covers (for example the EU), or confirm region rules are off.

## Gotchas

- **Pages that use a different base template.** If any page type has its own base template, it needs the snippet too. Put it in one shared head partial that every base template calls.
- **Keep a single consent banner.** Remove any other one, so visitors see one clear choice.
- **Use your own AppID**, and copy the snippet again after switching banner engine in the dashboard: changing the setting alone does not update a pasted snippet.

## More help

- [Where to put the Cookie Compliance snippet](https://cookie-compliance.co/documentation/where-to-put-the-consent-snippet/) — the placement rule, for the site owner.
- [Banner not displayed](https://cookie-compliance.co/documentation/banner-is-not-displayed/) — what to check when the banner does not show.