Location & Identity

`locationInfo`

The detected location data, available after initialization completes. Contains the user's country and region as resolved by the c15t backend (or overrides in offline mode).

const { locationInfo } = consentStore.getState();

if (locationInfo) {
  console.log('Country:', locationInfo.countryCode); // 'DE'
  console.log('Region:', locationInfo.regionCode); // 'BY'
}

Subscribe to location changes:

consentStore.subscribe((state, prevState) => {
  if (state.locationInfo !== prevState.locationInfo && state.locationInfo) {
    console.log('Location detected:', state.locationInfo.countryCode);
  }
});

`setOverrides(overrides)`

Override the detected geolocation. This re-runs initialization with the new location, which may change the consent model (e.g., switching from opt-out to opt-in when changing from US to DE).

const state = consentStore.getState();

// Override as EU visitor (triggers GDPR opt-in model)
await state.setOverrides({ country: 'DE' });

// Override as California visitor (triggers CCPA opt-out model)
await state.setOverrides({ country: 'US', region: 'CA' });

// Override country and language together
await state.setOverrides({ country: 'FR', language: 'fr' });

Info

setOverrides() triggers a new /init request to the backend (in c15t mode), so the resolved jurisdiction, model, and translations will update accordingly.

`setLanguage(language)`

Change the active language at runtime. This re-fetches the consent banner to get server-resolved translations for the new language.

const state = consentStore.getState();

// Switch to German
await state.setLanguage('de');

// Switch to French
await state.setLanguage('fr');

Use this to build a language switcher:

document
  .getElementById('lang-select')
  ?.addEventListener('change', async (e) => {
    const lang = (e.target as HTMLSelectElement).value;
    await consentStore.getState().setLanguage(lang);
  });

`identifyUser(user)`

Link an authenticated user identity to the consent record. This allows the c15t backend to associate consent across devices for the same user.

const state = consentStore.getState();

// After user logs in
await state.identifyUser({
  id: 'user_123',
  identityProvider: 'clerk',
});

The identityProvider field indicates which auth system provided the ID (e.g., 'clerk', 'auth0', 'custom').

Info

identifyUser() sends the user ID to the c15t backend. Only call this after the user has authenticated and consented to being identified.