Log in Get early access
Free scan Install guides Developers Compare CMPs About Support Contact
Get Velo

Already have an account? Log in

Drupal install guide

Add Velo to Drupal.

Install the Velo cookie banner and Google Consent Mode v2 on Drupal in minutes. One line in your theme template does it. If you already run Google Tag Manager, that route is on this page too.

Get started All install guides
Wherehtml.html.twig, or Asset Injector
PlanDrupal 9, 10 and 11
Goes liveAfter a cache flush
TimeAbout five minutes

Paste one line
before the head closes.

One line in Drupal, and the banner is on every page with the Consent Mode default set before any other tag can fire. Same banner, same wiring and the same audit log as the Tag Manager route.

Already running Google Tag Manager? Take that route instead ↓

Three steps · about five minutes

  1. 01

    Copy the line

    One script tag, the same on every page of the site. Everything below is about getting it into the right place, and that place is always the head, ahead of the tags it governs.

    <!-- Before your other tags. That order is the point. --> <script src="https://veloconsent.com/v1/velo.js" data-velo-site="your-site-id" defer></script>
  2. 02

    Add the tag to your theme

    Paste the snippet before </head> in your theme’s html.html.twig, or use the Asset Injector module if you prefer staying out of the theme. Clear caches after either.

    your-site.com/admin · Asset Injector
    The Drupal admin with the Velo snippet pasted into the site head
  3. 03

    Clear caches and reload

    Drupal caches rendered pages aggressively, so flush caches once. The banner then renders on every page with the Consent Mode default set before any other tag can fire. The snippet is static, so page caching stays effective.

    your-site.com
    An ordinary web page with the Velo consent banner in the bottom left corner
One thing to watch

Drupal caches rendered pages aggressively, so flush caches once after the edit. The snippet is identical for every visitor, so page cache and CDN cache both keep working — region resolution and the decision happen in the visitor's browser and at the edge, not in Drupal.

Recommended if you run a container

Or import the tag
in Tag Manager.

One tag, no code on the page, and your whole measurement stack stays in one place. No Tag Manager yet? The Google Tag module installs the container cleanly from your Drupal admin, then start here.

  1. 01Import the Velo CMP templateTemplates→Tag Templates→New→Import
  2. 02Create the tagTags→New→Velo CMP template
  3. 03Tick the two recovery optionsAdvanced→url_passthrough→ads_data_redaction
  4. 04Fire it on Consent Initialization – All PagesTriggering→Consent Initialization – All Pages
  5. 05Turn on consent overview under AdminAdmin→Container Settings→Enable consent overview
  6. 06Preview, then publishPreview→Submit→Publish
tagmanager.google.com
A new tag in Google Tag Manager using the Velo Consent Banner template, site ID filled in
The Tag Manager guide, screen by screen Six screens, about ten minutes, the same on every platform.

Drupal questions,
answered.

What teams installing on Drupal ask first.

Which Drupal versions does this cover?

The steps are written for Drupal 10 and 11 and work the same on 9. Velo is one script tag with no module dependency, so core and contrib updates never touch it.

Do I need a dedicated module?

No. A theme template or Asset Injector both work, and the Tag Manager route needs no code at all. If you already run the EU Cookie Compliance module, disable it so only one consent layer is active.

Will Drupal’s caching break it?

No. The snippet is identical for every visitor, so page cache and CDN cache both keep working. Region resolution and the consent decision happen in the visitor’s browser and at the edge, not in Drupal.

Will it slow the site down?

No. The script loads deferred, never blocks rendering, and the visitor's region is resolved at the nearest edge before the page finishes painting. The banner itself is a few kilobytes of static code.

Can an AI assistant do this for me?

Yes. Copy the prompt in Install with agents, just below, into Claude, ChatGPT, Cursor or whichever assistant you already use. It carries the steps on this page, the order the tags have to load in, and the checks the agent has to run before it tells you the job is done.

Or hand it
to an agent.

Copy the prompt into Claude, ChatGPT, Cursor or whichever assistant you already use. It carries everything on this page: both routes, the order the tags have to load in, and the checks that prove it worked.

The prompt

Paste it in as your first message, then swap your-site-id for the ID on your Velo dashboard. Everything else the agent needs is already written into it, including what to check before publishing.

Install prompt · Drupal
# Install Velo on Drupal: cookie banner + Google Consent Mode v2 You are installing Velo, a consent management platform, on my Drupal site. Velo shows the cookie banner, sets the Google Consent Mode v2 defaults before any other tag can fire, and records every decision. Ask me for these before you touch anything: - My Velo site id. It is in the Velo dashboard. No account yet? Send me to https://veloconsent.com/get-started and wait for the id. - Whether the site already runs Google Tag Manager, and which container. - Which cookie banner or consent tool is live on the site today. ## Path A: through Google Tag Manager (preferred when GTM is live) 1. Templates → Tag Templates → New, then ⋮ → Import. Import the template.tpl from github.com/ampliodata/velo-cmp ("Velo CMP"). 2. Create a tag from that template. Set my Velo site id and pick the light or dark theme. 3. Fire it on the "Consent Initialization – All Pages" trigger. Not Initialization, not All Pages. Both run too late to set consent defaults. 4. Preview, check the Consent tab in Tag Assistant, then Submit and Publish. No container yet? On Drupal, install the Google Tag module (drupal.org/project/google_tag) from Extend and add the container id under Configuration. ## Path B: the snippet, straight into the site Put this line in the <head>, above every analytics and advertising tag: <script src="https://veloconsent.com/v1/velo.js" data-velo-site="MY_SITE_ID" defer></script> On Drupal: paste the snippet before </head> in the theme's html.html.twig, or use the Asset Injector module to stay out of the theme. Clear caches either way. ## Rules - One path, never both. Two installs means two banners. - Velo loads first. Everything that measures or advertises comes after. - Only one tool may set Consent Mode defaults. If another consent module is enabled, disable it before Velo goes live. Leave no hard coded gtag('consent', 'default', ...) anywhere else either. - Change nothing beyond what this install needs. Tell me first if a theme file, plugin or existing tag has to be touched. ## Verify, then report back - The banner renders on a fresh load in a private window. - Before I choose, every consent signal except security_storage is denied from an EEA, UK or Swiss location. - Accepting and rejecting each flip the matching signals, and a velo_consent_update event lands in the data layer. - Google tags stay in their cookieless mode until consent is granted, and any tag gated by hand fires only after it. - window.Velo is defined, and Velo.open() reopens the preferences panel. - On a Tag Manager install, Tag Assistant shows the Velo tag firing on Consent Initialization ahead of every other tag. Tell me what you changed, where you changed it, and what each check showed. If a check fails, fix it and run the checks again. Full guide: https://veloconsent.com/drupal More context for agents: https://veloconsent.com/llms.txt

Working with an agent that reads the web? Point it at veloconsent.com/llms.txt and /install.md for the same context in plain text.

From the journal.

What consent modelling is, and when Google actually switches it on Consent modelling estimates what declined visitors did. 11 August 2026
GDPR cookie banner requirements in 2026, and the check that proves each one The things a GDPR cookie banner must do in 2026, each paired with the browser check that proves your own banner actually does it. 29 July 2026
How to check your cookie banner is sending the Consent Mode v2 signal Two reads settle it: the four consent signals inside the browser, and the state that actually reached Google on the request. 26 July 2026
All posts

Your banner, your consent,
your data — all in one place.

Scan your site →
Pages Free scan Product Agencies Pricing Developers Install guides Compare CMPs
Company About Velo Blog Help Contact
Account Sign up Log in Get early access
GDPR CCPA
All rights reserved
© 2026 by Amplio Data
Privacy Cookies Terms Refunds GDPR TCF Legal notice
EN ES FR PT