Cookie consent bannerCompliance scannerPrivacy policy generator
GuidesIndustriesAgenciesPricing
Log inStart for free

Developers

Documentation

Everything to install Consorm, manage consent and integrate your tools, from the first script to exporting the records.

Getting started

Automatic installation

The recommended method: Consorm creates and publishes a Google Tag Manager container for you, and you paste two code snippets into your site.

With the automatic method, Consorm creates a Google Tag Manager container dedicated to your site, installs the banner and Consent Mode v2 in it, then publishes it. You do not need a Google Tag Manager account: the container is managed by Consorm. Your only task is to paste the container's code into your site: the same operation as for any GTM.

Step 1: Add your site

  1. 1Sign in to app.consorm.com with your Google account.
  2. 2On the dashboard, choose Add site and enter your site's address (for example https://example.com). If your plan is at its site limit, this button leads to the plans page.
  3. 3You land on the Installation page. Keep the Automatic (recommended) tab.
  4. 4Click Create container. Within seconds, Consorm creates it, installs the banner in it and publishes it; its Container ID GTM-XXXXXXX appears. If a warning shows up at this step, click Deploy, top right, to resume publishing.

Step 2: Paste the code into your site

The Installation page shows two snippets, with your GTM-XXXXXXX ID already inserted; copy them from the dashboard rather than from here. The first goes as high as possible in the <head> of every page:

In the <head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
<!-- End Google Tag Manager -->

The second goes immediately after the opening of the <body>:

After <body>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

CMS and site builders

WordPress, Shopify, Webflow, Squarespace, Wix and most platforms offer a "header code" field or a script injection zone: paste the <head> snippet there. If your platform does not expose the <body>, the <noscript> snippet can be omitted: it only serves visitors without JavaScript.

Step 3: Verify the installation

Back on the Installation page, click Verify installation: Consorm loads your home page in a browser and watches the requests it sends, for up to a minute. Six results are possible:

ResultWhat it means
Installation confirmedThe banner loads on your site. The state is kept: the Installation tab shows a green check mark.
Code installed, configuration not publishedThe container is in place but your banner has not been published: click Deploy, top right.
GTM detected, banner missingGoogle Tag Manager loads, but without the Consorm tag: check the pasted container or, with the GTM template, the tag and its publication.
Not detectedNothing is visible yet. After publishing, propagation can take a few minutes: try again a little later.
Site unreachableThe address does not respond or is not public.
Verification errorA problem on our side, not yours: try again in a minute.

Until the installation is confirmed, the Installation tab shows an orange dot and a "Finish the installation" bar stays visible on the site's other tabs. You can also check for yourself: open your site in a private window; the banner must appear, and no request to your analytics tools should fire before your choice.

Going live: the Deploy button

Everything you change afterwards in the dashboard (banner appearance and copy, categories, providers) is saved as a draft. The Deploy button, top right, publishes in one go the banner configuration to our CDN and then the Google Tag Manager container. An Unpublished changes badge reminds you that a deployment is pending.

Redoing the installation

The Redo installation button on the Installation page deletes the container Consorm created in Google Tag Manager and resets the verification. The next container receives a new ID GTM-XXXXXXX: the old code pasted into your site becomes inactive and must be replaced. Reserve this action for complete reinstallations.

What comes next