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

Already have an account? Log in

HubSpot install guide

Add Velo to HubSpot.

Install the Velo cookie banner and Google Consent Mode v2 on HubSpot in minutes. One line in Site header HTML does it. If you already run Google Tag Manager, that route is on this page too.

Get started All install guides
WhereSettings → Website → Pages
PlanAny plan, domain connected
Goes liveOn save
TimeAbout two minutes

Paste one line
into Site header HTML.

One line in HubSpot, 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 two 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

    Open the site header settings

    In HubSpot, go to Settings → Website → Pages, choose the domain, and paste the snippet into Site header HTML. Save.

    app.hubspot.com · Settings
    The HubSpot admin with the Velo snippet pasted into the site head
  3. 03

    Reload any page

    Website pages, landing pages and the blog on that domain all inherit the header, so the banner is live everywhere at once with the Consent Mode default set before any other tag can fire.

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

Turn HubSpot's own banner off under Privacy & Consent first. And note that HubSpot's analytics is not a Google tag, so Consent Mode does not gate it by itself — if compliance requires that, load it through Tag Manager and gate it on the velo_consent_update event.

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 GTM container goes in the same Site header HTML box, 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.

HubSpot questions,
answered.

What teams installing on HubSpot ask first.

HubSpot already shows a cookie banner.

Turn HubSpot’s banner off under Privacy & Consent so Velo is the only layer your visitors see. Two banners confuse people, and two consent tools send Google conflicting signals.

Does it cover landing pages and the blog?

Yes. Everything HubSpot serves under the domain inherits the site header HTML, so one paste covers website pages, landing pages and blog posts alike.

What about HubSpot’s own tracking code?

HubSpot’s analytics is not a Google tag, so Consent Mode does not gate it by itself. If compliance requires it, load it through Tag Manager and gate it with the velo_consent_update event. The GTM guide shows the exact trigger.

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 · HubSpot
# Install Velo on HubSpot: cookie banner + Google Consent Mode v2 You are installing Velo, a consent management platform, on my HubSpot 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 HubSpot, HubSpot has no native GTM field, so paste the container snippet into the same place: Settings → Content → Pages → the domain → Site header HTML. ## 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 HubSpot: Settings → Website → Pages → choose the domain → the Site header HTML field → Save. ## 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. Turn HubSpot's own banner off under Privacy & Consent so Velo is the only layer visitors see. 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/hubspot 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