Documentation

Cookie Solution Delivery Channels

This article refers to the latest version of the Cookie Solution. If you haven’t already, we strongly recommend that you upgrade 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 of the latest version. Alternately, you can find the old guide related to the legacy version here.

iubenda’s Cookie Solution is available in three 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.

Cookie Solution Channels

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 = {
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        //other config options
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></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/cs/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 Channel

Before:


<head>
...

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        //other config options
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

...
</head>

After:


<head>
...

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        //other config options
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/beta/iubenda_cs.js" charset="UTF-8" async></script>

...
</head>

The Stable channel is linked to the following URL:

cdn.iubenda.com/cs/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 Channel

Before:


<head>
...

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        //other config options
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

...
</head>

After:


<head>
...

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        //other config options
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/stable/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/cs/versions/iubenda_cs-0.11.36.4.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