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

Already have an account? Log in

WordPress install guide

Add Velo to WordPress.

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

Get started All install guides
WhereCode Snippets → Header & Footer
PlanAny WordPress install
Goes liveOn save
TimeAbout three minutes

Paste one line
in Header & Footer.

One line in WordPress, 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 three 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

    Paste the snippet into your header

    Use a header plugin like WPCode: Code Snippets → Header & Footer, paste into the Header box, save. No plugin? Add the line to header.php in a child theme, right after the opening <head> tag.

    wp-admin · Code Snippets
    The WordPress admin with the Velo snippet pasted into the site head
  3. 03

    Reload the site

    That is the whole install. The banner renders on the next page load and the Consent Mode default is set before any tag on the page can fire. Caching plugins are fine. The snippet is static, so cached pages keep working.

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

Already running Complianz, Cookie Notice or another consent plugin? Deactivate it before Velo goes live. Two banners confuse visitors, and two tools writing Consent Mode defaults send Google conflicting signals.

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 on the site yet? Add the container first with a plugin like GTM4WP or Site Kit, publish it once, 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.

WordPress questions,
answered.

What teams installing on WordPress ask first.

Do I need a WordPress plugin?

No. Velo is one script tag, not a plugin. Any way of adding code to your header works: WPCode, your theme options, a child theme, or the Tag Manager route above. There is nothing to keep updated in your WordPress admin.

I already run a cookie plugin like Complianz or Cookie Notice.

Deactivate it before Velo goes live. Two banners confuse visitors, and two tools writing Consent Mode defaults send Google conflicting signals. Velo replaces the whole job: the banner, the region rules and the consent record.

Does it work with WooCommerce?

Yes. The banner and Consent Mode cover every page your theme renders, shop and cart included. Google tags keep firing under their built in consent checks, and visitors who decline are still modelled instead of vanishing from your reports.

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 · WordPress
# Install Velo on WordPress: cookie banner + Google Consent Mode v2 You are installing Velo, a consent management platform, on my WordPress 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 WordPress, add it with a plugin such as GTM4WP, GTM Kit or Google's own Site Kit, then paste the GTM-XXXXXXX id into the plugin settings. No theme editing needed. ## 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 WordPress: use a header plugin such as WPCode (Code Snippets → Header & Footer → the Header box → Save). Without a plugin, add the line to header.php in a child theme, immediately after the opening <head> tag. ## 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 a cookie plugin such as Complianz, CookieYes or Cookie Notice is active, deactivate 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/wordpress 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