This article refers to the legacy version of the Cookie Solution. For existing implementations (before 11.03.2019), we strongly suggest upgrading your Cookie Solution by simply copying the new code here (Dashboard > [Your website/app] > Cookie Solution > Embed) to avoid any CSS related conflicts and to access all the new features. If you’ve already updated your code to the new version, please find the updated Guide here.
iubenda’s Cookie Solution is available in 4 different versions that allow each user to choose the cycle of periodic updates that best suits their needs:
Current
The default version of the iubenda Cookie Solution is based on the Current channel. The Current version receives updates every two or three weeks; fixes are applied as soon as they are available.
Beta
Once they have been tested internally, all the last features are released on the Beta channel. Also in this case fixes are applied as soon as they are available.
Stable
The Stable channel is updated only if at least one month has passed since the release of the new features on the Current channel. Release dates are established at least two weeks in advance and, except in exceptional cases of particular relevance, fixes are applied on this channel only according to the scheduled release plan.
Safemode
Safemode is the new version of the iubenda Cookie Solution, improved in terms of speed, dependence on external libraries and security in snippets’ activation. More on the Introduction to Safemode post.
You can specify the version you want to use by using the dedicated dropdown menu, copying the resulting code and pasting it into the <head> tag (as the first element), replacing the default shown below:
<head>
...
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
cookiePolicyId: XxX,
siteId: YyY,
// ...other config options...
};
(function (w, d) {
var loader = function () { var s = d.createElement("script"), tag = d.getElementsByTagName("script")[0]; s.src = "//cdn.iubenda.com/cookie_solution/iubenda_cs.js"; tag.parentNode.insertBefore(s, tag); };
if (w.addEventListener) { w.addEventListener("load", loader, false); } else if (w.attachEvent) { w.attachEvent("onload", loader); } else { w.onload = loader; }
})(window, document);
</script>
...
</head>
The Cookie Solution connects by default to the Current channel. If you wish to use this channel, you do not need to make any changes to the Cookie Solution code automatically generated when the cookie policy is activated.
The Beta channel is linked to the following URL:
cdn.iubenda.com/cookie_solution/beta/iubenda_cs.js
To select the Beta channel, choose Beta from the dropdown menu next to “Embed the banner” (to get there: Dashboard > [Your site] > Cookie Solution > Embed), copy the resulting code and paste it into the HEAD tag of your site, replacing the previous one.
Before:
<head>
...
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
cookiePolicyId: XxX,
siteId: YyY,
// ...other config options...
};
(function (w, d) {
var loader = function () { var s = d.createElement("script"), tag = d.getElementsByTagName("script")[0]; s.src = "//cdn.iubenda.com/cookie_solution/iubenda_cs.js"; tag.parentNode.insertBefore(s, tag); };
if (w.addEventListener) { w.addEventListener("load", loader, false); } else if (w.attachEvent) { w.attachEvent("onload", loader); } else { w.onload = loader; }
})(window, document);
</script>
...
</head>
After:
<head>
...
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
cookiePolicyId: XxX,
siteId: YyY,
// ...other config options...
};
(function (w, d) {
var loader = function () {
var s = d.createElement("script"),
tag = d.getElementsByTagName("script")[0];
s.src = "//cdn.iubenda.com/cookie_solution/beta/iubenda_cs.js";
tag.parentNode.insertBefore(s, tag);
};
if (w.addEventListener) {
w.addEventListener("load", loader, false);
} else if (w.attachEvent) {
w.attachEvent("onload", loader);
} else {
w.onload = loader;
}
})(window, document);
</script>
...
</head>
The Stable channel is linked to the following URL:
cdn.iubenda.com/cookie_solution/stable/iubenda_cs.js
To select the Stable channel, choose Stable from the dropdown menu next to “Embed the banner” (to get there: Dashboard > [Your site] > Cookie Solution > Embed), copy the resulting code and paste it into the HEAD tag of your site, replacing the previous one.
Before:
<head>
...
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
cookiePolicyId: XxX,
siteId: YyY,
// ...other config options...
};
(function (w, d) {
var loader = function () { var s = d.createElement("script"), tag = d.getElementsByTagName("script")[0]; s.src = "//cdn.iubenda.com/cookie_solution/iubenda_cs.js"; tag.parentNode.insertBefore(s, tag); };
if (w.addEventListener) { w.addEventListener("load", loader, false); } else if (w.attachEvent) { w.attachEvent("onload", loader); } else { w.onload = loader; }
})(window, document);
</script>
...
</head>
After:
<head>
...
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
cookiePolicyId: XxX,
siteId: YyY,
// ...other config options...
};
(function (w, d) {
var loader = function () {
var s = d.createElement("script"),
tag = d.getElementsByTagName("script")[0];
s.src = "//cdn.iubenda.com/cookie_solution/stable/iubenda_cs.js";
tag.parentNode.insertBefore(s, tag);
};
if (w.addEventListener) {
w.addEventListener("load", loader, false);
} else if (w.attachEvent) {
w.attachEvent("onload", loader);
} else {
w.onload = loader;
}
})(window, document);
</script>
...
</head>
Safemode is linked to the following URL:
cdn.iubenda.com/cookie_solution/safemode/iubenda_cs.js
To select the Safemode channel, choose Safemode from the dropdown menu next to “Embed the banner” (to get there: Dashboard > [Your site] > Cookie Solution > Embed), copy the resulting code and paste it into the HEAD tag of your site, replacing the previous one.
Before:
<head>
...
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
cookiePolicyId: XxX,
siteId: YyY,
// ...other config options...
};
(function (w, d) {
var loader = function () { var s = d.createElement("script"), tag = d.getElementsByTagName("script")[0]; s.src = "//cdn.iubenda.com/cookie_solution/iubenda_cs.js"; tag.parentNode.insertBefore(s, tag); };
if (w.addEventListener) { w.addEventListener("load", loader, false); } else if (w.attachEvent) { w.attachEvent("onload", loader); } else { w.onload = loader; }
})(window, document);
</script>
...
</head>
After:
<head>
...
<script type="text/javascript">
var _iub = _iub || [];
_iub.csConfiguration = {
cookiePolicyId: XxX,
siteId: YyY,
// other config options
};
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cookie_solution/safemode/iubenda_cs.js" charset="UTF-8" async></script>
...
</head>
Here is an example of a typical scenario, useful to understand how updates works depending on the selected release channel:
If a fix is released on day 4, the Beta and Current channels will be updated immediately, while the Stable channel will not (unless particularly relevant fixes):
The release process then resumes as usual:
If you want to use a particular version of the Cookie Solution, edit the code by entering a similar URL:
cdn.iubenda.com/cookie_solution/versions/0.11.36.4/iubenda_cs.js
“0.11.36.4” is the version used in this case. To choose a different version, just edit “0.11.36.4”.
Important: available versions are only those released on the Current and Stable channels.
The complete changelog of various release channels is available at this link.