From b53150434ed7f9e4c8ac7777b22e4abe156d9d32 Mon Sep 17 00:00:00 2001
From: Timur Mashara <timur@metabase.com>
Date: Mon, 12 Oct 2026 12:23:56 +0200
Subject: [PATCH 1/2] Load VWO on every docs page and report cookie consent to
 it (GRO-1076)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 _includes/marketing-vwo.html     | 27 +++++++++++++++++++++++++--
 public/docs/js/cookie-consent.js | 16 +++++++++++++---
 2 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/_includes/marketing-vwo.html b/_includes/marketing-vwo.html
index 58ece0d3d2..d5e711aa2d 100644
--- a/_includes/marketing-vwo.html
+++ b/_includes/marketing-vwo.html
@@ -1,4 +1,28 @@
-{% if page.vwo or include.force_enabled %}
+  <script type="text/javascript" id="vwoConsent">
+    // VWO "Partially Block" mode: variations apply right away, tracking waits
+    // for init(1). `public/docs/js/cookie-consent.js` updates it once the visitor decides.
+    {
+      window.VWO = window.VWO || [];
+      window.VWO.init =
+        window.VWO.init ||
+        function (state) {
+          window.VWO.consentState = state;
+        };
+      const ACCEPTED = 1;
+      const PENDING = 2;
+      const REJECTED = 3;
+      const stored = document.cookie.match(/(?:^|; )gdprcookienotice=([^;]*)/);
+      let analytics;
+      try {
+        analytics = stored && JSON.parse(decodeURIComponent(stored[1])).analytics;
+      } catch {
+        analytics = undefined;
+      }
+      window.VWO.init(
+        analytics === true ? ACCEPTED : analytics === false ? REJECTED : PENDING,
+      );
+    }
+  </script>
   <!-- Start VWO Async SmartCode -->
   <link rel="preconnect" href="https://dev.visualwebsiteoptimizer.com" />
   <script type='text/javascript' id='vwoCode'>
@@ -16,4 +40,3 @@
     if(f=!1,v=d.querySelector('#vwoCode'),cc={},-1<d.URL.indexOf('__vwo_disable__')||w._vwo_code)return;try{var e=JSON.parse(localStorage.getItem('_vwo_'+account_id+'_config'));cc=e&&'object'==typeof e?e:{}}catch(e){}function r(t){try{return decodeURIComponent(t)}catch(e){return t}}var s=function(){var e={combination:[],combinationChoose:[],split:[],exclude:[],uuid:null,consent:null,optOut:null},t=d.cookie||'';if(!t)return e;for(var n,i,o=/(?:^|;\s*)(?:(_vis_opt_exp_(\d+)_combi=([^;]*))|(_vis_opt_exp_(\d+)_combi_choose=([^;]*))|(_vis_opt_exp_(\d+)_split=([^:;]*))|(_vis_opt_exp_(\d+)_exclude=[^;]*)|(_vis_opt_out=([^;]*))|(_vwo_global_opt_out=[^;]*)|(_vwo_uuid=([^;]*))|(_vwo_consent=([^;]*)))/g;null!==(n=o.exec(t));)try{n[1]?e.combination.push({id:n[2],value:r(n[3])}):n[4]?e.combinationChoose.push({id:n[5],value:r(n[6])}):n[7]?e.split.push({id:n[8],value:r(n[9])}):n[10]?e.exclude.push({id:n[11]}):n[12]?e.optOut=r(n[13]):n[14]?e.optOut=!0:n[15]?e.uuid=r(n[16]):n[17]&&(i=r(n[18]),e.consent=i&&3<=i.length?i.substring(0,3):null)}catch(e){}return e}();function i(){var e=function(){if(w.VWO&&Array.isArray(w.VWO))for(var e=0;e<w.VWO.length;e++){var t=w.VWO[e];if(Array.isArray(t)&&('setVisitorId'===t[0]||'setSessionId'===t[0]))return!0}return!1}(),t='a='+account_id+'&u='+encodeURIComponent(w._vis_opt_url||d.URL)+'&vn='+version+'&ph=1'+('undefined'!=typeof platform?'&p='+platform:'')+'&st='+w.performance.now();e||((n=function(){var e,t=[],n={},i=w.VWO&&w.VWO.appliedCampaigns||{};for(e in i){var o=i[e]&&i[e].v;o&&(t.push(e+'-'+o+'-1'),n[e]=!0)}if(s&&s.combination)for(var r=0;r<s.combination.length;r++){var a=s.combination[r];n[a.id]||t.push(a.id+'-'+a.value)}return t.join('|')}())&&(t+='&c='+n),(n=function(){var e=[],t={};if(s&&s.combinationChoose)for(var n=0;n<s.combinationChoose.length;n++){var i=s.combinationChoose[n];e.push(i.id+'-'+i.value),t[i.id]=!0}if(s&&s.split)for(var o=0;o<s.split.length;o++)t[(i=s.split[o]).id]||e.push(i.id+'-'+i.value);return e.join('|')}())&&(t+='&cc='+n),(n=function(){var e={},t=[];if(w.VWO&&Array.isArray(w.VWO))for(var n=0;n<w.VWO.length;n++){var i=w.VWO[n];if(Array.isArray(i)&&'setVariation'===i[0]&&i[1]&&Array.isArray(i[1]))for(var o=0;o<i[1].length;o++){var r,a=i[1][o];a&&'object'==typeof a&&(r=a.e,a=a.v,r&&a&&(e[r]=a))}}for(r in e)t.push(r+'-'+e[r]);return t.join('|')}())&&(t+='&sv='+n)),s&&s.optOut&&(t+='&o='+s.optOut);var n=function(){var e=[],t={};if(s&&s.exclude)for(var n=0;n<s.exclude.length;n++){var i=s.exclude[n];t[i.id]||(e.push(i.id),t[i.id]=!0)}return e.join('|')}();return n&&(t+='&e='+n),s&&s.uuid&&(t+='&id='+s.uuid),s&&s.consent&&(t+='&consent='+s.consent),w.name&&-1<w.name.indexOf('_vis_preview')&&(t+='&pM=true'),w.VWO&&w.VWO.ed&&(t+='&ed='+w.VWO.ed),t}code={nonce:v&&v.nonce,library_tolerance:function(){return'undefined'!=typeof library_tolerance?library_tolerance:void 0},settings_tolerance:function(){return cc.sT||settings_tolerance},hide_element_style:function(){return'{'+(cc.hES||hide_element_style)+'}'},hide_element:function(){return performance.getEntriesByName('first-contentful-paint')[0]?'':'string'==typeof cc.hE?cc.hE:hide_element},getVersion:function(){return version},finish:function(e){var t;f||(f=!0,(t=d.getElementById('_vis_opt_path_hides'))&&t.parentNode.removeChild(t),e&&((new Image).src='https://dev.visualwebsiteoptimizer.com/ee.gif?a='+account_id+e))},finished:function(){return f},addScript:function(e){var t=d.createElement('script');t.type='text/javascript',e.src?t.src=e.src:t.text=e.text,v&&t.setAttribute('nonce',v.nonce),d.getElementsByTagName('head')[0].appendChild(t)},load:function(e,t){t=t||{};var n=new XMLHttpRequest;n.open('GET',e,!0),n.withCredentials=!t.dSC,n.responseType=t.responseType||'text',n.onload=function(){if(t.onloadCb)return t.onloadCb(n,e);200===n.status?_vwo_code.addScript({text:n.responseText}):_vwo_code.finish('&e=loading_failure:'+e)},n.onerror=function(){if(t.onerrorCb)return t.onerrorCb(e);_vwo_code.finish('&e=loading_failure:'+e)},n.send()},init:function(){var e,t=this.settings_tolerance();w._vwo_settings_timer=setTimeout(function(){_vwo_code.finish()},t),'body'!==this.hide_element()?(n=d.createElement('style'),e=(t=this.hide_element())?t+this.hide_element_style():'',t=d.getElementsByTagName('head')[0],n.setAttribute('id','_vis_opt_path_hides'),v&&n.setAttribute('nonce',v.nonce),n.setAttribute('type','text/css'),n.styleSheet?n.styleSheet.cssText=e:n.appendChild(d.createTextNode(e)),t.appendChild(n)):(n=d.getElementsByTagName('head')[0],(e=d.createElement('div')).style.cssText='z-index: 2147483647 !important;position: fixed !important;left: 0 !important;top: 0 !important;width: 100% !important;height: 100% !important;background: white !important;',e.setAttribute('id','_vis_opt_path_hides'),e.classList.add('_vis_hide_layer'),n.parentNode.insertBefore(e,n.nextSibling));var n='https://dev.visualwebsiteoptimizer.com/j.php?'+i();-1!==w.location.search.indexOf('_vwo_xhr')?this.addScript({src:n}):this.load(n+'&x=true',{l:1})}};w._vwo_code=code;code.init();})();
   </script>
   <!-- End VWO Async SmartCode -->
-{% endif %}
diff --git a/public/docs/js/cookie-consent.js b/public/docs/js/cookie-consent.js
index 3e5c886c95..d7ed65dbc1 100644
--- a/public/docs/js/cookie-consent.js
+++ b/public/docs/js/cookie-consent.js
@@ -211,6 +211,12 @@
 
   // analytics
 
+  // VWO consent states: 1 = accepted, 3 = rejected (2 = pending is the
+  // initial state set in `_includes/marketing-vwo.html`).
+  function setVwoConsent(accepted) {
+    window.VWO?.init?.(accepted ? 1 : 3);
+  }
+
   let hasAnalyticsScripts = false;
   let haveConsent;
   function loadAnalyticsScripts(accepted) {
@@ -260,6 +266,9 @@
       (gdprcookie.analytics === undefined &&
         !geolocation.hasCookiePolicyRestriction);
     loadAnalyticsScripts(accepted);
+    // A stored choice was already passed to VWO in `marketing-vwo.html`; this
+    // covers implied consent outside restricted countries.
+    if (accepted) setVwoConsent(true);
   }
 
   function checkBarDismissed() {
@@ -332,9 +341,10 @@
       loadMarketingScripts();
     }
 
-    loadAnalyticsScripts(
-      typeof e.detail === "boolean" ? e.detail : e.detail.analytics,
-    );
+    const analytics =
+      typeof e.detail === "boolean" ? e.detail : e.detail.analytics;
+    loadAnalyticsScripts(analytics);
+    setVwoConsent(analytics);
 
     document.body.classList.add("cookies-accepted");
     hideBar();

From 856b776b5325c220f4b9dfd8ce7334d901945c46 Mon Sep 17 00:00:00 2001
From: Timur Mashara <timur@metabase.com>
Date: Tue, 13 Oct 2026 11:42:31 +0200
Subject: [PATCH 2/2] change hideElement to empty for non-experiment pages /
 load vwo only for prod build

---
 _includes/marketing-vwo.html             | 6 +++++-
 src/pages/docs/[version]/[...slug].astro | 7 ++++++-
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/_includes/marketing-vwo.html b/_includes/marketing-vwo.html
index d5e711aa2d..c69840cdee 100644
--- a/_includes/marketing-vwo.html
+++ b/_includes/marketing-vwo.html
@@ -1,3 +1,6 @@
+{% if jekyll.environment == "production" %}
+{% assign vwo_experiment_paths = "" | split: "," %}
+{% if vwo_experiment_paths contains page.url %}{% assign vwo_hide_element = "body" %}{% else %}{% assign vwo_hide_element = "" %}{% endif %}
   <script type="text/javascript" id="vwoConsent">
     // VWO "Partially Block" mode: variations apply right away, tracking waits
     // for init(1). `public/docs/js/cookie-consent.js` updates it once the visitor decides.
@@ -33,10 +36,11 @@
     var account_id=576439,
     version=2.2,
     settings_tolerance=2000,
-    hide_element='body',
+    hide_element='{{ vwo_hide_element }}',
     hide_element_style = 'opacity:0 !important;filter:alpha(opacity=0) !important;background:none !important';
     /* DO NOT EDIT BELOW THIS LINE */
     var f=0, v;
     if(f=!1,v=d.querySelector('#vwoCode'),cc={},-1<d.URL.indexOf('__vwo_disable__')||w._vwo_code)return;try{var e=JSON.parse(localStorage.getItem('_vwo_'+account_id+'_config'));cc=e&&'object'==typeof e?e:{}}catch(e){}function r(t){try{return decodeURIComponent(t)}catch(e){return t}}var s=function(){var e={combination:[],combinationChoose:[],split:[],exclude:[],uuid:null,consent:null,optOut:null},t=d.cookie||'';if(!t)return e;for(var n,i,o=/(?:^|;\s*)(?:(_vis_opt_exp_(\d+)_combi=([^;]*))|(_vis_opt_exp_(\d+)_combi_choose=([^;]*))|(_vis_opt_exp_(\d+)_split=([^:;]*))|(_vis_opt_exp_(\d+)_exclude=[^;]*)|(_vis_opt_out=([^;]*))|(_vwo_global_opt_out=[^;]*)|(_vwo_uuid=([^;]*))|(_vwo_consent=([^;]*)))/g;null!==(n=o.exec(t));)try{n[1]?e.combination.push({id:n[2],value:r(n[3])}):n[4]?e.combinationChoose.push({id:n[5],value:r(n[6])}):n[7]?e.split.push({id:n[8],value:r(n[9])}):n[10]?e.exclude.push({id:n[11]}):n[12]?e.optOut=r(n[13]):n[14]?e.optOut=!0:n[15]?e.uuid=r(n[16]):n[17]&&(i=r(n[18]),e.consent=i&&3<=i.length?i.substring(0,3):null)}catch(e){}return e}();function i(){var e=function(){if(w.VWO&&Array.isArray(w.VWO))for(var e=0;e<w.VWO.length;e++){var t=w.VWO[e];if(Array.isArray(t)&&('setVisitorId'===t[0]||'setSessionId'===t[0]))return!0}return!1}(),t='a='+account_id+'&u='+encodeURIComponent(w._vis_opt_url||d.URL)+'&vn='+version+'&ph=1'+('undefined'!=typeof platform?'&p='+platform:'')+'&st='+w.performance.now();e||((n=function(){var e,t=[],n={},i=w.VWO&&w.VWO.appliedCampaigns||{};for(e in i){var o=i[e]&&i[e].v;o&&(t.push(e+'-'+o+'-1'),n[e]=!0)}if(s&&s.combination)for(var r=0;r<s.combination.length;r++){var a=s.combination[r];n[a.id]||t.push(a.id+'-'+a.value)}return t.join('|')}())&&(t+='&c='+n),(n=function(){var e=[],t={};if(s&&s.combinationChoose)for(var n=0;n<s.combinationChoose.length;n++){var i=s.combinationChoose[n];e.push(i.id+'-'+i.value),t[i.id]=!0}if(s&&s.split)for(var o=0;o<s.split.length;o++)t[(i=s.split[o]).id]||e.push(i.id+'-'+i.value);return e.join('|')}())&&(t+='&cc='+n),(n=function(){var e={},t=[];if(w.VWO&&Array.isArray(w.VWO))for(var n=0;n<w.VWO.length;n++){var i=w.VWO[n];if(Array.isArray(i)&&'setVariation'===i[0]&&i[1]&&Array.isArray(i[1]))for(var o=0;o<i[1].length;o++){var r,a=i[1][o];a&&'object'==typeof a&&(r=a.e,a=a.v,r&&a&&(e[r]=a))}}for(r in e)t.push(r+'-'+e[r]);return t.join('|')}())&&(t+='&sv='+n)),s&&s.optOut&&(t+='&o='+s.optOut);var n=function(){var e=[],t={};if(s&&s.exclude)for(var n=0;n<s.exclude.length;n++){var i=s.exclude[n];t[i.id]||(e.push(i.id),t[i.id]=!0)}return e.join('|')}();return n&&(t+='&e='+n),s&&s.uuid&&(t+='&id='+s.uuid),s&&s.consent&&(t+='&consent='+s.consent),w.name&&-1<w.name.indexOf('_vis_preview')&&(t+='&pM=true'),w.VWO&&w.VWO.ed&&(t+='&ed='+w.VWO.ed),t}code={nonce:v&&v.nonce,library_tolerance:function(){return'undefined'!=typeof library_tolerance?library_tolerance:void 0},settings_tolerance:function(){return cc.sT||settings_tolerance},hide_element_style:function(){return'{'+(cc.hES||hide_element_style)+'}'},hide_element:function(){return performance.getEntriesByName('first-contentful-paint')[0]?'':'string'==typeof cc.hE?cc.hE:hide_element},getVersion:function(){return version},finish:function(e){var t;f||(f=!0,(t=d.getElementById('_vis_opt_path_hides'))&&t.parentNode.removeChild(t),e&&((new Image).src='https://dev.visualwebsiteoptimizer.com/ee.gif?a='+account_id+e))},finished:function(){return f},addScript:function(e){var t=d.createElement('script');t.type='text/javascript',e.src?t.src=e.src:t.text=e.text,v&&t.setAttribute('nonce',v.nonce),d.getElementsByTagName('head')[0].appendChild(t)},load:function(e,t){t=t||{};var n=new XMLHttpRequest;n.open('GET',e,!0),n.withCredentials=!t.dSC,n.responseType=t.responseType||'text',n.onload=function(){if(t.onloadCb)return t.onloadCb(n,e);200===n.status?_vwo_code.addScript({text:n.responseText}):_vwo_code.finish('&e=loading_failure:'+e)},n.onerror=function(){if(t.onerrorCb)return t.onerrorCb(e);_vwo_code.finish('&e=loading_failure:'+e)},n.send()},init:function(){var e,t=this.settings_tolerance();w._vwo_settings_timer=setTimeout(function(){_vwo_code.finish()},t),'body'!==this.hide_element()?(n=d.createElement('style'),e=(t=this.hide_element())?t+this.hide_element_style():'',t=d.getElementsByTagName('head')[0],n.setAttribute('id','_vis_opt_path_hides'),v&&n.setAttribute('nonce',v.nonce),n.setAttribute('type','text/css'),n.styleSheet?n.styleSheet.cssText=e:n.appendChild(d.createTextNode(e)),t.appendChild(n)):(n=d.getElementsByTagName('head')[0],(e=d.createElement('div')).style.cssText='z-index: 2147483647 !important;position: fixed !important;left: 0 !important;top: 0 !important;width: 100% !important;height: 100% !important;background: white !important;',e.setAttribute('id','_vis_opt_path_hides'),e.classList.add('_vis_hide_layer'),n.parentNode.insertBefore(e,n.nextSibling));var n='https://dev.visualwebsiteoptimizer.com/j.php?'+i();-1!==w.location.search.indexOf('_vwo_xhr')?this.addScript({src:n}):this.load(n+'&x=true',{l:1})}};w._vwo_code=code;code.init();})();
   </script>
   <!-- End VWO Async SmartCode -->
+{% endif %}
diff --git a/src/pages/docs/[version]/[...slug].astro b/src/pages/docs/[version]/[...slug].astro
index f87809bf30..cd61cd5f99 100644
--- a/src/pages/docs/[version]/[...slug].astro
+++ b/src/pages/docs/[version]/[...slug].astro
@@ -62,7 +62,12 @@ const page = { url, ...doc.data };
 
 // Process liquid first (e.g. control flow, includes, variables, etc)
 const lq = getLiquidRenderer({ page, dirname });
-const lqOutput = await lq.render(doc.body!, undefined, {
+// Standalone `.html` docs skip the shared head, so add VWO to their own `<head>`.
+const lqSource =
+  kind === "html"
+    ? doc.body!.replace("</head>", "{% include marketing-vwo.html %}</head>")
+    : doc.body!;
+const lqOutput = await lq.render(lqSource, undefined, {
   maxSyntaxErrors: version === "latest" ? 0 : 3,
 });