Skip to main content

Consent Gating

Consent gating adds an opt-in cookie-consent layer to your widget. When it is on, visitors are asked for consent before the selected categories run — visitor identification and session recording wait for a yes, while chat keeps working for everyone.

Consent gating is off by default. Nothing changes on your site unless you turn it on.

note

Consent gating is a tool, not legal advice. Configuring the categories and banner text to satisfy the regulations that apply to your visitors is your responsibility as the site owner.

Turning It On​

Go to Settings > Widget > Install and open the Advanced section. The Consent gating master toggle sits at the top. As the setting itself puts it: "When on, visitors are asked for consent before the selected categories run. Configuring this correctly is your responsibility as the site owner."

Once enabled, the additional options below appear.

Block Widget Until Answered​

The Block widget until answered toggle controls what happens before the visitor makes a choice:

  • On — the widget stays hidden and nothing runs until the visitor answers the consent banner.
  • Off — the widget loads immediately, and consent is treated as accepted by default until the visitor says otherwise.

Under Ask visitors for consent on, choose which categories require consent:

CategoryWhat It Gates
IdentificationVisitor identification and enrichment — matching a session to a name or company
BehaviourSession recording — both live view and recorded replays
Calls recordingsReserved for a future release — coming later

Only the categories you enable appear in the visitor's preferences modal, and only those categories gate their feature. Chat is never gated — a visitor who declines everything still gets the full chat experience.

Customizing the Banner​

Everything the visitor reads is editable. Leave a field blank to use the default wording.

  • Title — the banner heading, "This website uses cookies" by default
  • First banner text — the message on the initial consent banner
  • Preferences modal text — the message in the detailed preferences view
  • Category labels and descriptions — the name and explanation shown for each category

You can also set three colors so the banner matches your site:

  • Accent — primary buttons and active toggles
  • Background — the banner and modal card
  • Text — headings

If your site already runs a consent management platform, skip the bundled banner and pass the visitor's choice to the widget directly:

// Accept everything
window.kkSetConsent(true)

// Or decide per category
window.kkSetConsent({ identification: true, behaviour: false })

kkSetConsent works even if you call it before the widget has initialized — the widget picks up the decision as soon as it loads.

What Changes for Visitors​

With consent gating on:

  • Visitor identification only starts after the visitor consents to the Identification category — see Identity Graph Overview.
  • Session recording only starts after the visitor consents to the Behaviour category — see Recorded Sessions.
  • Chat is always available. A visitor who declines every category can still have a full conversation.