Documentation

All instructions about how to set up Cookie-Script properly

Unlike one might think, scanning website cookies is not an easy task. Sure, it's pretty straight forward when it comes to usual cookies with fixed names. However some cookies are more special than others, therefore we have built some smart features into the Cookie Scanner.

There are two main categories of special cookies used out there. 

Cookies with unique names

Some cookie names are made of unique identifiers, which are different for every website. For example, Google Analytics might set up a cookie with a name _gat_UA-xxxxxxx-x. Here xxxxxxx-x is a unique identifier of a client using Google Analytics. 

We have implemented Cookie Scanner to be smart enough to treat those cookies in a special way when categorizing them and finding a proper description. When looking in the cookie database, Cookie Scanner ignores the unique part of a cookie and finds the proper category and description of such unique cookies. 

Cookies with random names

Some of popular content management systems generate session cookies with random names. For example, WooCommerce can set up a session cookie which looks like this:

wp_woocommerce_session_f919208d949256bc062e5c23e02ba9a2

where f919208d949256bc062e5c23e02ba9a2 is just a random string. Such cookies are not suitable for cookie report since the actual cookie name of every visitor will be different. 

Another issue with random name cookies is that every scanning of website cookies will generate an additional random name cookie. This will make the cookie report grow with time and fill the report with junk cookie names.

The main challenge with random name cookies is to understand which cookie names are randomly generated and do not store them as actual names, but save them as patterns.

Cookie Scanner automatically detects those cookies and saves them as a pattern in Cookie Report. This is set to avoid new session cookies being added to your Cookie Report after every automatic scanning. In fact, you can even add such a cookie manually, just follow our guidelines on how to make a pattern for random name cookies. For example, randomly generated WooCommerce session cookies would look like this: 

wp_woocommerce_session_[abcdef0123456789]{32}
If you found a random cookie that is not detected by our scanner, drop us a line and we will include such cookies to a list of automatically detected random name cookies.