Site color

Choose your site’s color palette.

Saved on this device.

Consent

ConsentPrivacy preferences

Let visitors choose which optional cookies and services your site may use, and change their preferences later.

Site navigation & services

Consent gives visitors control over optional cookies and services, such as analytics or marketing. Its banner offers Accept all, Reject non-essential, and Manage preferences. The preferences panel lets visitors choose individual categories while required categories stay enabled.

Consent remembers the saved choice and loads configured optional services only after permission is granted. Visitors can reopen preferences using either option above, change their choices, and save again.

Open privacy preferences

With consent enabled in your site configuration, Consent is included automatically. Choose either of these two ways to let visitors reopen their preferences after making a choice.

Add data-consent-action="open-panel" to a Btn or BtnLink in your footer, navigation, or page content. Clicking it opens the privacy preferences panel.

For a button:

<Btn tone="neutral" variant="outline" data-consent-action="open-panel">
  Manage privacy settings
</Btn>

For a link:

<BtnLink
  href="/legal/privacy/"
  tone="neutral"
  variant="link"
  data-consent-action="open-panel"
>
  Privacy settings
</BtnLink>

2. Use the default teleport area

Place this empty element where you want the default Privacy settings button to appear:

<span class="consent-settings-teleport-area"></span>

Consent automatically places its settings button inside that element. SiteFooter already provides this area. If the area is absent, Consent does not add a settings button.

Make and revise a choice

This preview uses this site's real consent settings and shares its saved privacy choice. Open settings to review the configured categories.

All ten semantic tones

All supported values are visible together on the actual component, in an isolated document.

All ten semantic tonesCOMPOSITION

Samples follow this guide’s theme. Service appearance comparisons do not register account, search, or consent services.

All eighteen visual variants

All supported values are visible together on the actual component, in an isolated document.

All eighteen visual variantsCOMPOSITION

Samples follow this guide’s theme. Service appearance comparisons do not register account, search, or consent services.

Both variant modes

Compare stateless and stateful outlineFill treatments. Hover the samples; a stateful surface does not create new application behavior.

Both variant modesCOMPOSITION

Samples follow this guide’s theme. Service appearance comparisons do not register account, search, or consent services.

Every step of the preference flow

Use the working example to open, save, close, and reopen this site's real privacy settings. It shares the site's categories, services, and storage key.

The complete choice lifecycleCOMPOSITION
BannerPrivacy choices

Accept all · Reject optional · Manage preferences · Read the privacy policy.

Preference panelNecessary + optional categories

Required categories are locked. Optional categories can be changed before saving.

Saved choiceSettings remain available

Reopen from the settings control, revise preferences, and save again.

Policy or storage resetA fresh decision

A new policyVersion or clearing the example storage brings back the banner.

Required categories remain enabled. A saved choice is checked against policyVersion; changing that version asks for a fresh decision.

Configuration

Configuration Visible role
enabled Determines whether the component renders.
storageKey, policyVersion Set where choices are saved and when visitors must make a fresh choice.
categories Give each category an ID, label, description, and required flag.
services Associate each optional service with the category that gives it permission to load.
Banner, action, and settings labels Customize the language of the banner, buttons, and preferences.
privacyPolicyUrl, privacyPolicyLabel Add the policy destination beside the banner copy.

Keep category labels and descriptions specific to the services your site uses.

API reference

Consent contract

Appearance props style the component; settingsTeleport places its settings button. Banner copy, categories, storage, policy version and services come from site.consent, not markup props.

Composition

Consent is included automatically when enabled. Use a Btn or BtnLink with data-consent-action="open-panel" to open preferences, or provide .consent-settings-teleport-area for the default settings button. No public slots.