Hey! These docs are for version 2, which is no longer officially supported. Click here for the latest version, 3!

Cookie domain


New version available

Changes in v3 make this v2 document is obsolete.

📘This configuration option should only be used if you're running FingerprintJS Pro on multiple subdomains and want the identification process to span all of them.

When you're using FingerprintJS Pro on multiple subdomains, you need to configure the cookieDomain .


import { FP } from "@fp-pro/client"

let fp = await FP.load({
  region: "us", 
  client: "token", 
  cookieDomain: "example.com"

For instance, you're running the Pro version on foo.example.com and bar.example.com. In order for the identification cookie to work on both subdomains, configure the cookieDomain to be example.com.
This will set the cookie for .example.com top-level domain and all subdomains.

📘Note that the cookie domain shouldn't include the preceding dot.

cookieDomain: ".example.com"
cookieDomain: "example.com"