Contact usRequest a demo

This document describes version 5 of Unblu. If you’re using the latest major version of Unblu, go to the documentation of the latest version.

The support period for version 5 ended on 22 November 2021. We no longer provide support or updates for this version. You should upgrade to the latest version of Unblu.

How to set the cookie domain so that a session remains active after navigating to a sub-domain


I would like to configure a cookie domain for the Unblu application in such a way that an existing Unblu session can remain active when a visitor navigates to a sub-domain.


Unblu supports sub-domain switching. This means a session can remain active if there is a navigation to another sub-domain. This requires a definition of a cookie domain in the Unblu server configuration file (

The following property should be used to define a cookie domain:


A cookie domain can be set in one of the following ways; depending on the requirement/use-case (valid from Unblu 3.5.x and all new versions):

  1. If no sub-domain-switch is required: then no cookie domain needs to be defined. In this way Unblu uses the current context origin as the cookie domain. For example, consider the visitor is on In this case Unblu uses as the cookie domain when creating cookies.

  2. If a sub-domain-switch (only for one domain) is desired: it requires a cookie domain to be set as follows:

    In this case Unblu will use as a cookie domain when creating cookies. As a result, a sub-domain switch is possible. This means if the visitor navigates to a sub-domain (let us say to and the Unblu snippet is present on that page, the Unblu session will remain active.

  3. If a sub-domain-switch is required (for more than one domain): a cookie domain should be set as follows:


    In this case Unblu will set the cookie domain to the second level domain of the current context origin. For example, consider the visitor is on In this case Unblu uses as the cookie domain. As a result, a sub-domain-switch is possible for multiple domains (but only for the current context origin domain).

The property com.unblu.identifier.cookieDomain is considered only for the visitor context origin. This means your agent does not have to access the "Unblu Agent Desk" through the same origin defined via com.unblu.identifier.cookieDomain.