Add Velo
to WordPress.
Install the Velo cookie banner and Google Consent Mode v2 on WordPress with the Velo Consent plugin. Most installs take a few minutes when you already have admin access to the site. Prefer not to add a plugin? You can paste one line in your site header or use Google Tag Manager instead.
Instructions and image sources reviewed 23 September 2026.
Install the Velo Consent
plugin.
The Velo Consent plugin sets up your cookie banner and Google Consent Mode v2 in a couple of clicks, and connects to the WP Consent API. Prefer not to add a plugin? Paste one line in your header or use Google Tag Manager instead.
Already using Google Tag Manager? Skip the plugin and do it there ↓
Four steps · about two minutes
-
01
Download the plugin zip
Download the Velo Consent plugin zip below. The plugin is coming soon to the WordPress.org plugin directory; until then, install it directly from this zip file.
-
02
Upload and activate in WordPress
In your WordPress admin, open Plugins → Add Plugin and click Upload Plugin at the top of the page (older WordPress versions call the menu Add New). Choose velo-consent.zip, click Install Now, then click Activate Plugin when the upload finishes.
Real WordPress capture · 9 November 2026 The Upload Plugin screen in WordPress 7.1, with velo-consent.zip selected and ready to install.
WordPress ↗View full size ↗ -
03
Connect to Velo
Open Settings → Velo Consent and click Connect to Velo. Sign in or create a free Velo account and your site is linked in one click, with no site IDs to copy. If you already have a site ID, open Enter a site ID manually, paste it and click Save.
Real WordPress capture · 9 November 2026 Settings → Velo Consent on a test WordPress site, before connecting.
WordPress ↗View full size ↗ -
04
Check the status and the live site
On Settings → Velo Consent, the status check should show the banner snippet as active and no other consent plugin. The plugin prints velo.js at the top of your head so Consent Mode v2 defaults run before queued scripts. To make WooCommerce, Site Kit by Google and WP Statistics follow each visitor’s choice, also install the free WP Consent API plugin; Velo passes the choice to it once it is active. Clear any page or CDN cache, then open your live site in a private window to test the banner.
Real WordPress capture · 9 November 2026 After connecting. This test site has the WP Consent API plugin installed and uses Velo’s demo site ID, northwind.
WordPress ↗View full size ↗
Real WordPress capture · 9 November 2026 The banner on the same test site, using Velo’s demo site. Your banner’s copy, layout and region settings may differ.
WordPress ↗View full size ↗
Already running Complianz, CookieYes, Cookie Notice or another consent plugin? Deactivate it before Velo goes live, as the status checklist under Settings → Velo Consent reminds you. Two banners confuse visitors, and two tools writing Consent Mode defaults send Google conflicting signals.
Still comparing options? Read why teams use Velo on WordPress, or see every supported platform.
Prefer not to add a plugin?
Paste one line in Header & Footer.
Add your site’s snippet to the site-wide head with WPCode or a child theme’s header.php, then publish and test the result.
Alternative · header snippet
-
01
Copy the line
Copy the complete installation snippet for this site from your Velo dashboard. The example below shows the format; replace your-site-id before using it. Keep the API endpoint supplied by your dashboard.
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app.veloconsent.com" data-velo-site="your-site-id" async></script> -
02
Paste into WPCode’s Header field
In WordPress, open Code Snippets → Header & Footer in WPCode. Paste your complete Velo snippet into Header and save. Use a plugin-enabled WordPress installation; do not add a second copy if your theme already loads Velo.
Official documentation image, reviewed 23 September 2026 The Header field in WPCode’s official documentation. Replace its example with the complete snippet copied from Velo.
WPCode documentation ↗View full size ↗ -
03
Publish and check the live site
Save and publish the change using the platform steps above, then clear any site or CDN cache. Open the published URL in a fresh browser session. Check the banner where your region rules require it, test accepting and rejecting, and verify consent defaults and updates before your measurement tags run. Confirm the site appears as installed in your Velo dashboard.
Use Tag Manager?
Skip the code.
If Google Tag Manager is already on your site, this is the easiest way to add Velo. There’s no code to touch, it takes four short steps, and all your tags stay in one place.
- 01
Add Velo to Tag Manager
Open the Velo template, click Add to workspace, then pick your container.
Open the Velo template ↗ - 02
Paste your site ID
In Tag Manager, open Tags and click New. Click Tag Configuration, choose Velo CMP and paste your site ID. You’ll find it in your Velo dashboard. Leave everything else as it is.
- 03
Make it load first
Click Triggering, choose Consent Initialization – All Pages, then click Save. This lets Velo start before your other tags.
- 04
Publish and check it
Click Submit, then Publish. Preview alone doesn’t put Velo live. Then open your site in a private window, try the banner, and check that it shows as installed in your Velo dashboard.
WordPress questions,
answered.
What teams installing on WordPress ask first.
Do I need a WordPress plugin?
No, though the Velo Consent plugin is the fastest option. It adds the banner, configures Google Consent Mode v2, and connects to the WP Consent API in a couple of clicks. If you prefer not to add a plugin, paste one script line into your header with WPCode or a child theme, or install through Google Tag Manager.
I already run a cookie plugin like Complianz or Cookie Notice.
Deactivate it before Velo goes live. The status checklist under Settings → Velo Consent warns you if another consent plugin is active. 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. When you use the Velo Consent plugin, it also passes each visitor’s choice to the WP Consent API, so WooCommerce, Site Kit by Google and WP Statistics follow it automatically.
Will it slow the site down?
The dashboard snippet loads asynchronously. As with any script, measure its effect on your site and check your tag order; asynchronous loading alone does not guarantee consent defaults run before other tags.
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.
Paste this prompt into your assistant, then provide your site ID and the complete installation snippet or GTM settings from your Velo dashboard.
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.
