Documentation

Table of Contents

Cookie Solution Delivery Channels (legacy)

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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

Cookie Solution - Safemode

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, 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>

How to change the release channel

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.

Cookie Solution - Beta

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.

Cookie Solution - Stable

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.

Cookie Solution - Safemode

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>

Example

Here is an example of a typical scenario, useful to understand how updates works depending on the selected release channel:

  • On day 0 version 0.11.36 is available on all channels
  • On day 1, version 0.12.0 is released on the Beta channel
  • On day 2, version 0.12.1 is released on the Beta channel
  • On day 4, version 0.12.2 is released on the Beta channel
  • On day 1 + 2 weeks, version 0.12.2 is released on the Current channel
  • On the day 1 + 3 weeks, users of the Stable channel are notified of the upcoming release of version 0.12.2
  • On day 1 + 4 weeks, version 0.12.2 is released on the Stable 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):

  • On day 3, version 0.12.2 is released on the Beta channel
  • On day 3, version 0.11.37 is released on the Current channel

The release process then resumes as usual:

  • On day 4, version 0.12.3 is released on the Beta channel
  • On day 1 + 2 weeks, version 0.12.3 is released on the Current channel
  • On the day 1 + 3 weeks, users of the Stable channel are notified of the upcoming release of version 0.12.3
  • On day 1 + 4 weeks, version 0.12.3 is released on the Stable channel

How to choose a specific version of the Cookie Solution

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.

Changelog

The complete changelog of various release channels is available at this link.

Still have questions?

Visit our support forum Email us