(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[6433],{6172:function(e,a,n){(window.__NEXT_P=window.__NEXT_P||[]).push(["/installation/upgrade-v2.8",function(){return n(2802)}])},2802:function(e,a,n){"use strict";n.r(a),n.d(a,{__toc:function(){return g},default:function(){return c}});var t=n(5893),o=n(2673),i=n(7913),s=n(2702);n(9128);var r=n(2643),d={src:"/_next/static/media/upgrade-needed.2b6e8851.png",height:280,width:363,blurDataURL:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAGCAMAAADJ2y/JAAAADFBMVEX+/vT4+Orn6Nvt7uDfShtkAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAI0lEQVR4nCWIwREAAAzBkP137lEPIpKtD9g7JAmFiprvwfYABOYAKNQ6nMgAAAAASUVORK5CYII=",blurWidth:8,blurHeight:6},l={src:"/_next/static/media/latest-version.6b6fda84.png",height:282,width:359,blurDataURL:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAGCAMAAADJ2y/JAAAACVBMVEX0//Tu/u7k8+VS8x1KAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAIUlEQVR4nGNgYGRkZAADJiYmCJsJBEAMMA/CAAGIMhAJAAQzACFQlT2xAAAAAElFTkSuQmCC",blurWidth:8,blurHeight:6};let g=[{depth:2,value:"Changes in Version 2.8",id:"changes-in-version-28"},{depth:2,value:"How to Upgrade?",id:"how-to-upgrade"},{depth:3,value:"Upgrading CookieHub",id:"upgrading-cookiehub"},{depth:3,value:"Upgrading Implementation",id:"upgrading-implementation"},{depth:4,value:"Tag Installation",id:"tag-installation"},{depth:4,value:"WordPress Plugin",id:"wordpress-plugin"},{depth:4,value:"Google Tag Manager",id:"google-tag-manager"}];function _createMdxContent(e){let a=Object.assign({h1:"h1",p:"p",h2:"h2",strong:"strong",ul:"ul",li:"li",a:"a",h3:"h3",ol:"ol",img:"img",h4:"h4"},(0,r.a)(),e.components);return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(a.h1,{children:"Upgrade Guide (Version 2.8)"}),"\n",(0,t.jsx)(a.p,{children:"This guide will instruct you on how to upgrade to CookieHub 2.8 from earlier versions and covers both the upgrade process in the CookieHub dashboard and changes required to the CookieHub implementation on your website."}),"\n",(0,t.jsx)(a.h2,{id:"changes-in-version-28",children:"Changes in Version 2.8"}),"\n",(0,t.jsx)(a.p,{children:"We have made various changes related to consent mode to fulfill Google CMP requirements. These changes apply both to the widget core code and the Google Tag Manager implementation, making it necessary to manually update the Google Tag Manager implementation for those who don't use the CookieHub GTM community template."}),"\n",(0,t.jsx)(a.p,{children:(0,t.jsx)(a.strong,{children:"Notable Changes"})}),"\n",(0,t.jsxs)(a.ul,{children:["\n",(0,t.jsxs)(a.li,{children:["\n",(0,t.jsx)(a.p,{children:"Consent mode defaults are now sent in a codeless way, both when using the latest CookieHub GTM community template and with manual HTML code implementation."}),"\n"]}),"\n",(0,t.jsxs)(a.li,{children:["\n",(0,t.jsx)(a.p,{children:"The consent mode update signal is now only sent after users have interacted with the CookieHub dialog, either allowing or denying all or certain categories. Previously, CookieHub sent a consent update signal with the default consent to make sure the initial consent reflected the consent settings for the detected region. Due to this change, domains with multiple regions and implementing in GTM will now have to specify the regional defaults in the GTM template."}),"\n"]}),"\n",(0,t.jsxs)(a.li,{children:["\n",(0,t.jsx)(a.p,{children:"A list of services belonging to each category, along with links to their privacy policies and lists of cookies, is shown in the Category section of the Preference Center."}),"\n"]}),"\n",(0,t.jsxs)(a.li,{children:["\n",(0,t.jsx)(a.p,{children:"Mapping of consent mode signals for ad_storage to TCF 2.2 purposes & features was changed to Google's recommended setup."}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(a.p,{children:["A full list of changes is available in the ",(0,t.jsx)(a.a,{href:"/getting-started/change-log",children:"Change Log"}),"."]}),"\n",(0,t.jsx)(a.h2,{id:"how-to-upgrade",children:"How to Upgrade?"}),"\n",(0,t.jsx)(a.p,{children:"The upgrade to CookieHub 2.8 is done in two steps. First, you'll have to upgrade the CookieHub service, which activates the latest CookieHub widget, and then upgrade the implementation, which either involves replacing the HTML implementation code or upgrading the CookieHub template in Google Tag Manager."}),"\n",(0,t.jsx)(a.h3,{id:"upgrading-cookiehub",children:"Upgrading CookieHub"}),"\n",(0,t.jsx)(a.p,{children:"Follow these steps to upgrade to CookieHub 2.8:"}),"\n",(0,t.jsxs)(a.ol,{children:["\n",(0,t.jsxs)(a.li,{children:["Log in to the ",(0,t.jsx)(a.a,{href:"https://dash.cookiehub.com",children:"CookieHub dashboard"}),"."]}),"\n",(0,t.jsx)(a.li,{children:"Select the domain you wish to upgrade."}),"\n",(0,t.jsx)(a.li,{children:"In the Overview tab, you will see a box with information about the current version and if there's an update available."}),"\n",(0,t.jsxs)(a.li,{children:["If you are not using the latest version, you will see a message similar to this:\n",(0,t.jsx)(a.img,{alt:"Upgrade needed",placeholder:"blur",src:d})]}),"\n",(0,t.jsx)(a.li,{children:'Click the "Upgrade to 2.8.0" button and then confirm in the dialog shown with detailed information about the update.'}),"\n",(0,t.jsxs)(a.li,{children:['After the upgrade has been completed, you should see the message "You are using the latest version of CookieHub." in the box previously indicating that an upgrade was available.\n',(0,t.jsx)(a.img,{alt:"Latest version in use",placeholder:"blur",src:l})]}),"\n",(0,t.jsx)(a.li,{children:'The changes should be published automatically, but if you see a button at the top "Publish pending changes," click it to publish the changes.'}),"\n"]}),"\n",(0,t.jsx)(a.h3,{id:"upgrading-implementation",children:"Upgrading Implementation"}),"\n",(0,t.jsx)(a.p,{children:"When you have upgraded CookieHub to the latest version, you may need to upgrade the implementation as well. Refer to the following list of implementation methods to find the next steps."}),"\n",(0,t.jsx)(a.h4,{id:"tag-installation",children:"Tag Installation"}),"\n",(0,t.jsxs)(a.p,{children:["If you implemented CookieHub on your website by inserting the HTML implementation code, you may be using an old code with outdated consent mode default settings. Follow the ",(0,t.jsx)(a.a,{href:"/installation/tag",children:"Tag Installation Instructions"})," to find out how to locate the correct implementation code and replace the current code with the new one."]}),"\n",(0,t.jsxs)(a.p,{children:[(0,t.jsx)(a.strong,{children:"Please Note:"})," Previous tag installation codes included code to set the consent mode defaults. CookieHub now provides a codeless way to set the consent mode defaults, which also sets regional defaults if you have multiple regions active."]}),"\n",(0,t.jsx)(a.h4,{id:"wordpress-plugin",children:"WordPress Plugin"}),"\n",(0,t.jsxs)(a.p,{children:["If you are currently using the ",(0,t.jsx)(a.a,{href:"https://wordpress.org/plugins/cookiehub/",children:"CookieHub WordPress plugin"}),", you don't have to do anything except make sure you have the latest version of the WordPress plugin installed."]}),"\n",(0,t.jsx)(a.h4,{id:"google-tag-manager",children:"Google Tag Manager"}),"\n",(0,t.jsxs)(a.p,{children:["If you are currently using Google Tag Manager to implement CookieHub, follow the ",(0,t.jsx)(a.a,{href:"/installation/google-tag-manager-upgrade",children:"Google Tag Manager Upgrade Instructions"})," to make sure you have the latest CookieHub GTM community template installed."]}),"\n",(0,t.jsxs)(a.p,{children:[(0,t.jsx)(a.strong,{children:"Please Note:"})," CookieHub does not set consent mode defaults using a consent update command anymore. Due to this, you may need to set regional defaults manually in the CookieHub GTM template as instructed in the upgrade guide."]})]})}let u={MDXContent:function(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},{wrapper:a}=Object.assign({},(0,r.a)(),e.components);return a?(0,t.jsx)(a,{...e,children:(0,t.jsx)(_createMdxContent,{...e})}):_createMdxContent(e)},pageOpts:{filePath:"pages/installation/upgrade-v2.8.mdx",route:"/installation/upgrade-v2.8",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:"Upgrade Guide (Version 2.8)",headings:g},pageNextRoute:"/installation/upgrade-v2.8",nextraLayout:i.ZP,themeConfig:s.Z};var c=(0,o.j)(u)},2702:function(e,a,n){"use strict";var t=n(5893);a.Z={logo:(0,t.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,t.jsxs)("span",{children:["\xa9",new Date().getFullYear()," CookieHub"]})}}},5789:function(){}},function(e){e.O(0,[9774,4543,2888,179],function(){return e(e.s=6172)}),_N_E=e.O()}]);