(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[6608],{2031:function(e,n,t){(window.__NEXT_P=window.__NEXT_P||[]).push(["/advanced/known-issues",function(){return t(8200)}])},8200:function(e,n,t){"use strict";t.r(n),t.d(n,{__toc:function(){return d}});var a=t(5893),o=t(2673),i=t(7913),s=t(2702);t(9128);var r=t(2643);let d=[{depth:2,value:"VWO flickering issues",id:"vwo-flickering-issues"},{depth:2,value:"WP Rocket",id:"wp-rocket"},{depth:3,value:"Understanding the Issue",id:"understanding-the-issue"},{depth:3,value:"Excluding CookieHub from WP Rocket",id:"excluding-cookiehub-from-wp-rocket"},{depth:2,value:"Cloudflare Rocket Loader",id:"cloudflare-rocket-loader"},{depth:3,value:"Understanding the Compatibility Adjustment",id:"understanding-the-compatibility-adjustment"},{depth:3,value:'How to Apply the data-cfasync="false" Attribute for CookieHub',id:"how-to-apply-the-data-cfasyncfalse-attribute-for-cookiehub"}];function _createMdxContent(e){let n=Object.assign({h1:"h1",h2:"h2",p:"p",pre:"pre",code:"code",span:"span",h3:"h3",ul:"ul",li:"li",ol:"ol",strong:"strong",a:"a"},(0,r.a)(),e.components);return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{children:"Known issues & workarounds"}),"\n",(0,a.jsx)(n.h2,{id:"vwo-flickering-issues",children:"VWO flickering issues"}),"\n",(0,a.jsx)(n.p,{children:"A few users have encountered problems while integrating VWO with CookieHub, which results in a momentary white page display after all elements have loaded and rendered in the browser. To prevent this issue, you can resolve it by incorporating the following CSS code into your website, ensuring that VWO cannot modify the opacity of the body element:"}),"\n",(0,a.jsx)(n.pre,{"data-language":"css","data-theme":"default",children:(0,a.jsxs)(n.code,{"data-language":"css","data-theme":"default",children:[(0,a.jsxs)(n.span,{className:"line",children:[(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:"body"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" {"})]}),"\n",(0,a.jsxs)(n.span,{className:"line",children:[(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-constant)"},children:"opacity"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-keyword)"},children:":"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-constant)"},children:"1 "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-keyword)"},children:"!important"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:";"})]}),"\n",(0,a.jsxs)(n.span,{className:"line",children:[(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-constant)"},children:"filter"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-keyword)"},children:":"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-constant)"},children:"none "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-keyword)"},children:"!important"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:";"})]}),"\n",(0,a.jsx)(n.span,{className:"line",children:(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:"}"})})]})}),"\n",(0,a.jsx)(n.h2,{id:"wp-rocket",children:"WP Rocket"}),"\n",(0,a.jsx)(n.p,{children:"WP Rocket is a popular caching solution for WordPress sites, designed to improve website performance and load times. However, caching mechanisms can sometimes interfere with the proper functioning of other important website tools, such as CookieHub. To ensure seamless operation, it's crucial to configure WP Rocket to exclude CookieHub's JavaScript files from being cached. This guide provides comprehensive instructions on how to achieve optimal compatibility."}),"\n",(0,a.jsx)(n.h3,{id:"understanding-the-issue",children:"Understanding the Issue"}),"\n",(0,a.jsx)(n.p,{children:"Caching by WP Rocket can occasionally lead to issues with the CookieHub widget, such as:"}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsx)(n.li,{children:"Delayed loading or initialization of the CookieHub widget."}),"\n",(0,a.jsx)(n.li,{children:"The automatic cookie blocking feature may not function as intended, potentially leading to compliance issues."}),"\n"]}),"\n",(0,a.jsx)(n.p,{children:"These problems arise because caching can serve static versions of JavaScript files, which may not interact correctly with dynamic content or user consent preferences managed by CookieHub."}),"\n",(0,a.jsx)(n.h3,{id:"excluding-cookiehub-from-wp-rocket",children:"Excluding CookieHub from WP Rocket"}),"\n",(0,a.jsx)(n.p,{children:"To prevent these issues, follow these steps to exclude CookieHub's JavaScript from WP Rocket's caching:"}),"\n",(0,a.jsxs)(n.ol,{children:["\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.strong,{children:"Navigate to WP Rocket Settings:"})," Log into your WordPress dashboard and go to the WP Rocket settings page, focusing on areas related to file optimization and caching."]}),"\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.strong,{children:"Locate the JavaScript Files Exclusion Section:"})," Within the WP Rocket settings, find the section dedicated to excluding JavaScript files from caching."]}),"\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.strong,{children:"Specify CookieHub Script Patterns for Exclusion:"})," Instead of identifying individual script URLs, use the following patterns to exclude all relevant CookieHub scripts:"]}),"\n"]}),"\n",(0,a.jsx)(n.pre,{"data-language":"html","data-theme":"default",children:(0,a.jsxs)(n.code,{"data-language":"html","data-theme":"default",children:[(0,a.jsx)(n.span,{className:"line",children:(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:"https://cdn.cookiehub.eu/c2/(.*).js"})}),"\n",(0,a.jsx)(n.span,{className:"line",children:(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:"https://cookiehub.net/c2/(.*).js"})})]})}),"\n",(0,a.jsx)(n.p,{children:"These patterns instruct WP Rocket to ignore caching for any JavaScript files loaded from these paths, ensuring that CookieHub functions correctly."}),"\n",(0,a.jsxs)(n.ol,{start:"4",children:["\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.strong,{children:"Apply and Save Changes:"})," After entering the exclusion patterns, save your modifications. It’s advisable to clear your site's cache to immediately apply the new settings."]}),"\n"]}),"\n",(0,a.jsxs)(n.p,{children:["Further information are available in the WP Rocket documentation:\n",(0,a.jsx)(n.a,{href:"https://docs.wp-rocket.me/article/976-exclude-files-from-defer-js",children:"Exclude files from Load JavaScript Deferred"})]}),"\n",(0,a.jsx)(n.h2,{id:"cloudflare-rocket-loader",children:"Cloudflare Rocket Loader"}),"\n",(0,a.jsxs)(n.p,{children:["While Cloudflare's Rocket Loader is a powerful tool for improving website load times by optimizing the delivery of JavaScript, its aggressive optimization techniques can sometimes interfere with the functionality of crucial scripts, such as those used by CookieHub for GDPR and CCPA compliance. To ensure that CookieHub operates seamlessly on your site without being impacted by Rocket Loader, Cloudflare offers a straightforward solution: marking specific scripts to be ignored by Rocket Loader using the ",(0,a.jsx)(n.code,{children:'data-cfasync="false"'})," attribute. Here's how to apply this adjustment for optimal compatibility."]}),"\n",(0,a.jsx)(n.h3,{id:"understanding-the-compatibility-adjustment",children:"Understanding the Compatibility Adjustment"}),"\n",(0,a.jsxs)(n.p,{children:["Rocket Loader enhances site performance by loading JavaScript files asynchronously. However, this can cause timing issues or initialization delays for scripts that require a more synchronous loading pattern, like CookieHub's cookie consent management scripts. By adding ",(0,a.jsx)(n.code,{children:'data-cfasync="false"'})," to a script tag, you explicitly instruct Rocket Loader to exclude this script from its asynchronous loading process, ensuring it loads in the order specified by the web page."]}),"\n",(0,a.jsxs)(n.h3,{id:"how-to-apply-the-data-cfasyncfalse-attribute-for-cookiehub",children:["How to Apply the ",(0,a.jsx)(n.code,{children:'data-cfasync="false"'})," Attribute for CookieHub"]}),"\n",(0,a.jsx)(n.p,{children:"To ensure CookieHub is excluded from Rocket Loader's optimization and function correctly, follow these steps:"}),"\n",(0,a.jsxs)(n.ol,{children:["\n",(0,a.jsxs)(n.li,{children:["\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.strong,{children:"Identify the CookieHub Script Tag:"})," Locate the HTML script tag for CookieHub on your web pages. It's typically inserted into the head or body of your HTML and can be identified by the source URL, which include CookieHub's domain (cdn.cookiehub.eu or cookiehub.net)."]}),"\n"]}),"\n",(0,a.jsxs)(n.li,{children:["\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.strong,{children:"Modify Script Tag:"})," Add the ",(0,a.jsx)(n.code,{children:'data-cfasync="false"'})," attribute to the CookieHub script in your site's HTML. For example, a script tag would be modified as follows:"]}),"\n"]}),"\n"]}),"\n",(0,a.jsx)(n.p,{children:"Before:"}),"\n",(0,a.jsx)(n.pre,{"data-language":"html","data-theme":"default",children:(0,a.jsx)(n.code,{"data-language":"html","data-theme":"default",children:(0,a.jsxs)(n.span,{className:"line",children:[(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:"<"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:"script"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-function)"},children:"src"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-keyword)"},children:"="}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:'"https://cdn.cookiehub.eu/c2/xxxxxxxx.js"'}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:"></"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:"script"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:">"})]})})}),"\n",(0,a.jsx)(n.p,{children:"After adding the attribute:"}),"\n",(0,a.jsx)(n.pre,{"data-language":"html","data-theme":"default",children:(0,a.jsx)(n.code,{"data-language":"html","data-theme":"default",children:(0,a.jsxs)(n.span,{className:"line",children:[(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:"<"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:"script"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-function)"},children:"data-cfasync"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-keyword)"},children:"="}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:'"false"'}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:" "}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-function)"},children:"src"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-keyword)"},children:"="}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:'"https://cdn.cookiehub.eu/c2/xxxxxxxx"'}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:"></"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-token-string-expression)"},children:"script"}),(0,a.jsx)(n.span,{style:{color:"var(--shiki-color-text)"},children:">"})]})})}),"\n",(0,a.jsx)(n.p,{children:"This modification tells Rocket Loader to load this script synchronously, respecting its position and dependencies."})]})}let l={MDXContent:function(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},{wrapper:n}=Object.assign({},(0,r.a)(),e.components);return n?(0,a.jsx)(n,{...e,children:(0,a.jsx)(_createMdxContent,{...e})}):_createMdxContent(e)},pageOpts:{filePath:"pages/advanced/known-issues.mdx",route:"/advanced/known-issues",timestamp:1721839578e3,pageMap:[{kind:"Meta",data:{index:{title:"Home",type:"page",display:"hidden"},"getting-started":{title:"Getting started",type:"page"},features:{title:"Features",type:"page"},installation:{title:"Installation",type:"page"},dashboard:{title:"Dashboard",type:"page"},advanced:{title:"Advanced",type:"page"}}},{kind:"Folder",name:"advanced",route:"/advanced",children:[{kind:"Meta",data:{index:"Introduction","google-tag-manager":"Google Tag Manager","consent-mode-v2-signals":"Consent mode v2 signals","javascript-api":"Javascript API",services:"External services",csp:"Content Security Policy (CSP)","known-issues":"Known issues & workarounds"}},{kind:"MdxPage",name:"consent-mode-v2-signals",route:"/advanced/consent-mode-v2-signals"},{kind:"MdxPage",name:"csp",route:"/advanced/csp"},{kind:"MdxPage",name:"google-tag-manager",route:"/advanced/google-tag-manager"},{kind:"MdxPage",name:"index",route:"/advanced"},{kind:"MdxPage",name:"javascript-api",route:"/advanced/javascript-api"},{kind:"MdxPage",name:"known-issues",route:"/advanced/known-issues"},{kind:"MdxPage",name:"services",route:"/advanced/services"}]},{kind:"Folder",name:"dashboard",route:"/dashboard",children:[{kind:"Meta",data:{index:"Getting started",authentication:"Authentication",account:"Account",vendors:"Vendors",services:"Services",billing:"Billing","---":{type:"separator",title:"Domains"},"domain-overview":"Overview","add-domain":"Add domain","domain-settings":"Domain settings",implementation:"Implementation",customization:"Customization",languages:"Languages & Translations",regions:"Regions & Policy frameworks","cookie-management":"Cookie management",scans:"Scans","consent-log":"Consent log",reports:"Reports"}},{kind:"MdxPage",name:"account",route:"/dashboard/account"},{kind:"MdxPage",name:"add-domain",route:"/dashboard/add-domain"},{kind:"MdxPage",name:"authentication",route:"/dashboard/authentication"},{kind:"MdxPage",name:"billing",route:"/dashboard/billing"},{kind:"MdxPage",name:"consent-log",route:"/dashboard/consent-log"},{kind:"MdxPage",name:"cookie-management",route:"/dashboard/cookie-management"},{kind:"MdxPage",name:"customization",route:"/dashboard/customization"},{kind:"MdxPage",name:"domain-overview",route:"/dashboard/domain-overview"},{kind:"MdxPage",name:"domain-settings",route:"/dashboard/domain-settings"},{kind:"MdxPage",name:"implementation",route:"/dashboard/implementation"},{kind:"MdxPage",name:"index",route:"/dashboard"},{kind:"MdxPage",name:"languages",route:"/dashboard/languages"},{kind:"MdxPage",name:"regions",route:"/dashboard/regions"},{kind:"MdxPage",name:"reports",route:"/dashboard/reports"},{kind:"MdxPage",name:"scans",route:"/dashboard/scans"},{kind:"MdxPage",name:"services",route:"/dashboard/services"},{kind:"MdxPage",name:"vendors",route:"/dashboard/vendors"}]},{kind:"Folder",name:"features",route:"/features",children:[{kind:"Meta",data:{index:"Introduction","cookie-scanner":"Cookie scanner","cookie-declaration":"Cookie declaration","automatic-cookie-blocker":"Automatic cookie blocker",regions:"Regions / Geo-targeting",languages:"Languages & translations","policy-frameworks":"Policy frameworks","consent-log":"Consent log",accessibility:"Accessibility",linker:"Linker",reports:"Reports","---":{type:"separator",title:"Integrations"},"google-tag-manager":"Google Tag Manager","google-consent-mode":"Consent mode","shopify-customer-privacy":"Shopify Customer Privacy API","iab-tcf":"IAB Transparency and Consent Framework (TCF)","google-additional-consent-mode":"Google Additional Consent Mode","iab-us-privacy":"IAB US Privacy (CCPA)","global-privacy-control":"Global Privacy Control"}},{kind:"MdxPage",name:"accessibility",route:"/features/accessibility"},{kind:"MdxPage",name:"automatic-cookie-blocker",route:"/features/automatic-cookie-blocker"},{kind:"MdxPage",name:"consent-log",route:"/features/consent-log"},{kind:"MdxPage",name:"cookie-declaration",route:"/features/cookie-declaration"},{kind:"MdxPage",name:"cookie-scanner",route:"/features/cookie-scanner"},{kind:"MdxPage",name:"global-privacy-control",route:"/features/global-privacy-control"},{kind:"MdxPage",name:"google-additional-consent-mode",route:"/features/google-additional-consent-mode"},{kind:"MdxPage",name:"google-consent-mode",route:"/features/google-consent-mode"},{kind:"MdxPage",name:"google-tag-manager",route:"/features/google-tag-manager"},{kind:"MdxPage",name:"iab-tcf",route:"/features/iab-tcf"},{kind:"MdxPage",name:"iab-us-privacy",route:"/features/iab-us-privacy"},{kind:"MdxPage",name:"index",route:"/features"},{kind:"MdxPage",name:"languages",route:"/features/languages"},{kind:"MdxPage",name:"linker",route:"/features/linker"},{kind:"MdxPage",name:"policy-frameworks",route:"/features/policy-frameworks"},{kind:"MdxPage",name:"regions",route:"/features/regions"},{kind:"MdxPage",name:"reports",route:"/features/reports"},{kind:"MdxPage",name:"shopify-customer-privacy",route:"/features/shopify-customer-privacy"}]},{kind:"Folder",name:"getting-started",route:"/getting-started",children:[{kind:"Meta",data:{index:"Introduction","cookie-categories":"Cookie categories","subscriptions-and-pricing":"Subscriptions & pricing","resellers-affiliates":"Reseller & affiliates","data-processing-and-security":"Data Processing & Security",faq:"FAQ",support:"Support","change-log":"Change log","release-notes":"Release notes"}},{kind:"MdxPage",name:"change-log",route:"/getting-started/change-log"},{kind:"MdxPage",name:"cookie-categories",route:"/getting-started/cookie-categories"},{kind:"MdxPage",name:"data-processing-and-security",route:"/getting-started/data-processing-and-security"},{kind:"MdxPage",name:"faq",route:"/getting-started/faq"},{kind:"MdxPage",name:"index",route:"/getting-started"},{kind:"Folder",name:"release-notes",route:"/getting-started/release-notes",children:[{kind:"MdxPage",name:"cookiehub-2.7",route:"/getting-started/release-notes/cookiehub-2.7"},{kind:"Meta",data:{"cookiehub-2.7":"Cookiehub 2.7"}}]},{kind:"MdxPage",name:"resellers-affiliates",route:"/getting-started/resellers-affiliates"},{kind:"MdxPage",name:"subscriptions-and-pricing",route:"/getting-started/subscriptions-and-pricing"},{kind:"MdxPage",name:"support",route:"/getting-started/support",frontMatter:{title:"Support",sidebar_position:200}}]},{kind:"MdxPage",name:"index",route:"/"},{kind:"Folder",name:"installation",route:"/installation",children:[{kind:"Meta",data:{index:"Getting started","upgrade-v2.8":"Upgrade guide","consent-mode-v2":"Consent mode","-":{type:"separator",title:"Tag installation"},tag:"Installation","content-management-systems":"Content Management Systems",wordpress:"Wordpress",matomo:"Matomo Tag Manager",troubleshooting:"Troubleshooting","---":{type:"separator",title:"Google Tag Manager"},"google-tag-manager":"Installation","google-tag-manager-upgrade":"Upgrade","additional-consent":"Additional consent","consent-overview":"Consent overview","----":{type:"separator",title:"Digging deeper"},"conditional-html-tags":"Conditional HTML tags","cookie-declaration":"Cookie declaration","resurface-dialog":"Resurface dialog",linker:"Linker"}},{kind:"MdxPage",name:"additional-consent",route:"/installation/additional-consent"},{kind:"MdxPage",name:"conditional-html-tags",route:"/installation/conditional-html-tags"},{kind:"MdxPage",name:"consent-mode-v2",route:"/installation/consent-mode-v2"},{kind:"MdxPage",name:"consent-overview",route:"/installation/consent-overview"},{kind:"MdxPage",name:"content-management-systems",route:"/installation/content-management-systems"},{kind:"MdxPage",name:"cookie-declaration",route:"/installation/cookie-declaration"},{kind:"MdxPage",name:"google-tag-manager-upgrade",route:"/installation/google-tag-manager-upgrade"},{kind:"MdxPage",name:"google-tag-manager",route:"/installation/google-tag-manager"},{kind:"MdxPage",name:"index",route:"/installation"},{kind:"MdxPage",name:"linker",route:"/installation/linker"},{kind:"MdxPage",name:"matomo",route:"/installation/matomo"},{kind:"MdxPage",name:"resurface-dialog",route:"/installation/resurface-dialog"},{kind:"MdxPage",name:"tag",route:"/installation/tag"},{kind:"MdxPage",name:"troubleshooting",route:"/installation/troubleshooting"},{kind:"MdxPage",name:"upgrade-v2.8",route:"/installation/upgrade-v2.8"},{kind:"MdxPage",name:"wordpress",route:"/installation/wordpress"}]}],flexsearch:{codeblocks:!0},title:"Known issues & workarounds",headings:d},pageNextRoute:"/advanced/known-issues",nextraLayout:i.ZP,themeConfig:s.Z};n.default=(0,o.j)(l)},2702:function(e,n,t){"use strict";var a=t(5893);n.Z={logo:(0,a.jsx)("span",{children:"CookieHub Docs"}),primaryHue:360,primarySaturation:100,editLink:{text:""},feedback:{content:null},sidebar:{defaultMenuCollapseLevel:2,autoCollapse:!0},useNextSeoProps:()=>({titleTemplate:"%s – CookieHub Docs"}),banner:{},footer:{text:(0,a.jsxs)("span",{children:["\xa9",new Date().getFullYear()," CookieHub"]})}}},5789:function(){}},function(e){e.O(0,[9774,4543,2888,179],function(){return e(e.s=2031)}),_N_E=e.O()}]);