# Install Velo — cookie banner + Google Consent Mode v2

You are installing Velo, a consent management platform, on the user's
website. There are two install paths. Prefer Google Tag Manager
whenever the site runs it — one tag in the container, no code on the
page. The direct snippet is the fallback for sites without GTM.

## Steps

1. Check whether the site runs Google Tag Manager: look for a
   GTM-XXXXXXX container id, a googletagmanager.com/gtm.js request,
   or a first party proxy of it, in the page source or codebase.
2. GTM present? Install through it (recommended). In the container:
   - Templates → Search Gallery → add "Velo Consent Banner
     (Consent Mode v2)" by Amplio Data to the workspace.
   - Create a tag from the template and set the user's Velo site id;
     pick the light or dark theme.
   - Fire it on the Consent Initialization – All Pages trigger.
     Never Initialization or All Pages — both run too late for
     consent defaults.
   - Preview, then Submit and Publish.
   Full guide: https://veloconsent.com/google-tag-manager
3. No GTM? Place this snippet in the <head>, before any analytics or
   marketing tags — that order matters, Velo must set consent
   defaults first:

   <script src="https://veloconsent.com/v1/velo.js"
     data-velo-site="YOUR_SITE_ID" defer></script>

   The platform guides below show exactly where it goes.
4. Replace YOUR_SITE_ID with the user's site id from the Velo
   dashboard. If they do not have one yet, send them to
   https://veloconsent.com/get-started
5. Install ONE path, never both — two installs means two banners.

## Platform guides

| Platform | Guide |
| --- | --- |
| WordPress | https://veloconsent.com/wordpress |
| Shopify | https://veloconsent.com/shopify |
| Webflow | https://veloconsent.com/webflow |
| Framer | https://veloconsent.com/framer |
| Wix | https://veloconsent.com/wix |
| Squarespace | https://veloconsent.com/squarespace |
| Drupal | https://veloconsent.com/drupal |
| HubSpot | https://veloconsent.com/hubspot |
| Square Online | https://veloconsent.com/square |
| Google Tag Manager | https://veloconsent.com/google-tag-manager |
| Duda | https://veloconsent.com/duda |
| Shopware | https://veloconsent.com/shopware |
| BigCommerce | https://veloconsent.com/bigcommerce |
| Custom stack or anything else | https://veloconsent.com/developers |

## Verify

- The banner renders on a fresh page load.
- Before the visitor chooses, Google consent defaults are denied in the
  EEA and the UK.
- In a GTM install, the Velo tag fires on Consent Initialization before
  every other tag.
- Marketing and analytics tags fire only after consent is granted.
- window.Velo is defined, and Velo.open() reopens the preferences
  panel.

More context for agents: https://veloconsent.com/llms.txt
