Shopify install guide

Add Velo to Shopify

Install the Velo cookie banner and Google Consent Mode v2 on Shopify with the Velo Consent app from the Shopify App Store. It turns on in your theme editor with no code to edit, and passes every visitor’s choice to Shopify’s Customer Privacy API. If you’d rather not add an app, you can paste one line into theme.liquid or use Google Tag Manager instead.

Instructions and image sources reviewed 19 November 2026.

Works with the platforms you build on

WordPressShopifyWebflowWixHubSpotPrestaShopDrupalBigCommerceShopwareNext.jsAstroSquare

What you need on Shopify

Before you start

  • Where. Velo Consent app · or Edit code → theme.liquid
  • Plan. Any plan with Online Store
  • Goes live. On theme save
  • Typical time. About two minutes

Once it is live

  • Your banner follows the defaults you set for each visitor’s region.
  • Tags wait until the visitor has chosen.
  • Every choice is recorded, and Consent Mode v2 passes it on to your Google tags.
CMConsent Mode v2GPCGlobal Privacy ControlEUGDPRUSUS state laws

Two ways to install Velo on Shopify

Pick the route that matches how your site already loads its tags. Both end with the same banner and the same signals.


Install the Velo Consent app

The Velo Consent app adds your cookie banner as a theme app embed, sets the Google Consent Mode v2 defaults and passes every visitor’s choice to Shopify’s Customer Privacy API, so Shopify pixels and checkout follow it. Prefer not to add an app? Paste one line in theme.liquid or use Google Tag Manager instead.

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.

About two minutesTypical time to install on Shopify
On theme saveWhen the banner goes live
1,500Monthly sessions on the Free plan, for one site
Already running another consent app? Turn it off before Velo goes live. Two banners confuse visitors, and two tools writing Consent Mode defaults send Google conflicting signals.
!
One thing to watchShopify install
See every supported platform

Everything a consent setup needs

The same banner, records and scans on every plan. Pro adds unlimited sites, unlimited scans and your own logo.


Your banner asks in the visitor’s language and follows the defaults you set for their region.

Every choice is recorded, and Consent Mode v2 passes it on to your Google tags.


Google Consent Mode v2Advanced mode on every plan, with a Google Tag Manager template.
Rules by visitor countryOpt in where the law asks for it, and stricter rules for up to 60 countries.
US privacy lawsAn opt out banner with a “Do not sell or share” option.
Global Privacy ControlGPC signals are honoured on every plan.
Reject as easy as acceptReject sits next to accept on the first layer.
The visitor’s languagePicked from their browser, with your own banner text in each language.
Layouts and themesCorner, bar or centred box, in your colours, light or dark.
A/B test your bannerRun 2 to 8 versions of the banner side by side.
Consent logEvery decision is kept for 3 years, with receipt lookup by ID.
Consent dashboardAccept and reject rates over 7 to 90 days.
Cookie and tracker scansCategories from known signatures, plus AI suggestions that you approve.
Script blockingScripts wait for their consent category before they run.

Install the Velo Consent app

The Velo Consent app adds your cookie banner as a theme app embed, sets the Google Consent Mode v2 defaults and passes every visitor’s choice to Shopify’s Customer Privacy API, so Shopify pixels and checkout follow it. Prefer not to add an app? Paste one line in theme.liquid or use Google Tag Manager instead.

Install from the Shopify App Store

Open Velo Consent: Cookie Banner on the Shopify App Store, click Install and approve it in your Shopify admin. The app sets up Velo for your store, so there’s no site ID to copy. It’s free for up to 10,000 sessions a month, and Pro is $5 a month, billed through Shopify. View on the Shopify App Store

The Velo Consent app in Shopify admin, with colours, layout and a live preview
The Velo Consent app inside Shopify admin: pick your colours and layout, and the preview on the right updates as you go. Real Shopify capture · 19 November 2026. Shopify App Store ↗

Turn on the banner

In the app, click Turn on in theme editor. Your theme editor opens on App embeds with Velo Consent already switched on. Click Save, then go back to the app and click I’ve turned it on to confirm the banner is live.

Switch off Shopify’s own banner and check the store

Click Open customer privacy settings in the app and turn off Shopify’s cookie banner, so visitors aren’t asked twice. Then open your storefront in a private window, try Reject and Accept all, and check that your measurement tags follow the choice.

A Shopify storefront with the Velo cookie banner in the bottom corner
The banner on a Shopify test store once the app embed is saved, with Reject and Accept all side by side. Real Shopify capture · 19 November 2026. Shopify App Store ↗

Prefer not to add an app? Paste one line into your theme

Add your site’s snippet to the head of your theme, then publish and test it on the live site.

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.

Example snippet
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app-staging.veloconsent.com" data-velo-site="your-site-id" async></script>

Open layout/theme.liquid

Open Online Store → Themes, use the theme’s actions menu and choose Edit code. Open layout/theme.liquid and paste your complete Velo snippet inside the head, before your measurement scripts. Save the theme. This installs on the storefront; checkout needs its own supported integration.

Shopify: theme code editor
Shopify’s current theme editor. Open layout/theme.liquid and use the head of your storefront theme; checkout is a separate surface. Official documentation image, reviewed 23 September 2026. Shopify documentation ↗

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.

Velo’s banner with its default look. Your banner’s copy, colours and region settings may differ.

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.

The complete Tag Manager guide

Add Velo to Tag Manager

Open the Velo template, click Add to workspace, then pick your container. Open the Velo template ↗

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.

Make it load first

Click Triggering, choose Consent Initialization – All Pages, then click Save. This lets Velo start before your other tags.

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.

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.

Install with AI

The prompt

Paste this prompt into your assistant, then provide your site ID and the complete installation snippet or GTM settings from your Velo dashboard.

Install prompt · Shopify
Install Velo on Shopify.

Current guide: https://veloconsent.com/shopify

Before editing, get my site ID and complete installation snippet or GTM settings from the Velo dashboard. Confirm which consent tool and measurement tags already run on the site.

Choose one installation route:
A. If the site already uses Google Tag Manager, add the Velo CMP template (published by veloconsent) from the Community Template Gallery. Set my site ID, theme and API endpoint from the dashboard. Review the advanced options; ads_data_redaction and url_passthrough default to off. Use Consent Initialization – All Pages, then Preview and verify consent before publishing. Full steps: https://veloconsent.com/google-tag-manager

B. For direct installation: Open Online Store → Themes, use the theme’s actions menu and choose Edit code. Open layout/theme.liquid and paste your complete Velo snippet inside the head, before your measurement scripts. Save the theme. This installs on the storefront; checkout needs its own supported integration.

Preserve unrelated code. Avoid duplicate Velo installs or competing consent defaults. Do not assume a head placement or async loading alone guarantees tag order.

Check the published site in a fresh session. Verify the banner under the configured region rules, initial consent defaults, accept/reject updates and the velo_consent_update event. Check that non-Google tags follow their assigned categories. Test a second page and any separate checkout surface. Confirm signals reach the Velo dashboard.

Report what changed, where it changed and the result of each check. Describe any missing access or checks you could not complete.
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

Notes on cookie banners, Consent Mode and the data that goes missing between them.


How to set up Google Consent Mode v2 on Shopify
V
The Velo journal2 September 2026

Do Canadian websites need Google Consent Mode v2?

11 November 2026Read the post

Google Consent Mode v2 in Velo: what is new

2 November 2026Read the post

Common questions about Velo on Shopify

Do I need the Shopify app?

It’s the quickest route and the one we recommend. The Velo Consent app turns the banner on from your theme editor with no code to edit, and passes every choice to Shopify’s Customer Privacy API so Shopify pixels and checkout follow it. It’s free for up to 10,000 sessions a month. If you’d rather not add an app, one line in theme.liquid gives you the same banner and Consent Mode v2 on your storefront.

What about the checkout?

Shopify’s checkout is hosted by Shopify and doesn’t run theme code, so the banner appears on your storefront. The Velo Consent app passes each choice to Shopify’s Customer Privacy API, which checkout and Shopify pixels read, so they follow the same decision. With the theme code route, the choice still applies to your storefront tags, but Shopify itself isn’t told.

I already use a consent app.

Remove or disable it before publishing Velo. Two banners on one store confuse visitors, and two tools setting Consent Mode defaults send Google conflicting signals.

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.

Free for one site

Banner, scan and consent records for one site, free. Pro from €7 a month, plus VAT, for unlimited sites.