Google Consent Mode v2

If you use Google Tag Manager, GA4, or Google Ads, enable Google Consent Mode v2 so your tags wait for user approval before firing.

Enable it

{
  googleConsentMode: {
    enabled: true,
    waitForUpdate: 500,   // ms to wait for consent before loading tags
    adsDataRedaction: true,
    urlPassthrough: false,
  },
}

Order matters

The cookie consent plugin must be listed before any Google plugin so its default-denied consent signals are set before GTM/gtag loads:

plugins: [
  [
    'docusaurus-plugin-cookie-consent',
    {
      googleConsentMode: { enabled: true },
    },
  ],
  // Google plugins come after
  ['@docusaurus/plugin-google-gtag', { trackingID: 'G-XXXXXXXXXX' }],
];

How it works

1. Before GTM loads, optional Google consent signals are set to denied; security_storage remains granted.
2. On page load, valid, unexpired stored consent is applied immediately if present.
3. When the user changes or resets consent, gtag('consent', 'update', ...) fires.

GTM tag configuration

For tags inside GTM to respect this:

1. Admin → Container Settings → Enable consent overview
2. For each tag, set its consent requirement:
   • Analytics tags: require analytics_storage
   • Ads/marketing tags: require ad_storage

Consent signal mapping

Plugin category	Google consent signal(s)
analytics	analytics_storage
marketing	ad_storage, ad_user_data, ad_personalization
functional	functionality_storage, personalization_storage
necessary	security_storage (always granted)