Consent and Cookieless

FastStats supports normal analytics, anonymous cookieless analytics, and fully disabled collection. Choose an initial mode with consent and change it at runtime with setConsentMode.

How Identifiers WorkCopy Anchor Link

With granted consent, the SDK keeps an anonymous identifier in localStorage and session state in browser storage. This allows it to recognize returning visitors and measure sessions. Anonymous mode stores no anonymous identifier, so visitors cannot be recognized across reloads.

Consent ModesCopy Anchor Link

The default is "granted". If consent has not yet been decided, start with "anonymous" for cookieless counts or "denied" to send nothing.

Copy Text
<Analytics siteKey="your_site_key" consent="denied" />

Set cookieless: true when a site should always avoid stored identifiers. This forces cookieless collection even while consent is "granted".

Update Consent at RuntimeCopy Anchor Link

Copy Text
import { useConsentMode } from "@faststats/react";

const setConsentMode = useConsentMode();

<button onClick={() => setConsentMode("granted")}>Accept</button>
<button onClick={() => setConsentMode("denied")}>Decline</button>

Switching to "denied" stops collection and discards data buffered by active extensions. Switching back starts tracking again. Moving between "anonymous" and "granted" rotates the page and identity context so the two modes do not share an anonymous identifier.

Controlled React ConsentCopy Anchor Link

The React component applies changes to its consent prop to the active client, which works well when your consent manager already exposes React state.

Copy Text
<Analytics siteKey="your_site_key" consent={consentMode} />