Setting Consent

saveConsents(type)

The primary way to persist consent. Accepts one of three strategies:

const { saveConsents } = useConsentManager();

// Accept all - sets every active category to true
await saveConsents('all');

// Reject all - only necessary stays true, everything else false
await saveConsents('necessary');

// Save current selections - persists whatever the user toggled
await saveConsents('custom');

What happens when you call saveConsents:

Consent state is updated in the store
UI closes (activeUI → 'none')
Consent is saved to localStorage and cookie
If consent was revoked and reloadOnConsentRevoked is true, the page reloads
Otherwise, scripts/iframes/network blocker are updated
Consent is synced to the backend API

setConsent(name, value)

Updates a single consent category AND automatically saves it. Use this for simple one-off consent changes:

const { setConsent } = useConsentManager();

// Grant measurement consent immediately
setConsent('measurement', true);

// Revoke marketing consent immediately
setConsent('marketing', false);

setSelectedConsent(name, value)

Updates the selection state without saving. This is what dialog toggles use - the user can flip toggles without committing until they click "Save":

const { setSelectedConsent, saveConsents } = useConsentManager();

// User toggles measurement on
setSelectedConsent('measurement', true);

// User toggles marketing off
setSelectedConsent('marketing', false);

// User clicks "Save" - now it persists
await saveConsents('custom');

resetConsents()

Resets all consent preferences to their default values and clears stored consent:

const { resetConsents } = useConsentManager();

resetConsents();
// All consents back to defaults, consent info cleared

Accept All / Reject All Patterns

Common patterns for banner buttons:

function ConsentActions() {
  const { saveConsents } = useConsentManager();

  return (
    <div>
      <button onClick={() => saveConsents('necessary')}>Reject All</button>
      <button onClick={() => saveConsents('all')}>Accept All</button>
    </div>
  );
}