Documentation

Cookie Solution Delivery Channels

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.

You can always specify the version you want to use by including its URL in the code of the Cookie Solution and then replace it with the default URL – that is, the one in the standard code as shown in the example 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 modify the Cookie Solution code by entering the above URL in place of the default one, as shown in the example below.

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 modify the Cookie Solution code by entering the above URL in place of the default one, as shown in the example below.

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 start using Safemode, edit the Cookie Solution code by entering the URL above to replace the default one, as shown in the example below.

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