Localization

Select a locale

<Banner isOpen locale="de-AT" bannerContent={{ acceptAllLabel: 'Zustimmen' }} />

Locale resolution trims whitespace, ignores case and falls back from a regional tag to its base language. en-GB resolves to English, de-AT to German; unsupported or empty inputs use English.

Selection is explicit. Use the same locale for SSR and hydration. There is no browser language detection or storage access.

Override only what changes

bannerContent accepts partial banner and preferences messages. preferencesContent changes per-section titles and descriptions. Omitted fields retain translated defaults.

<Banner
  isOpen
  locale="de"
  preferencesContent={{ essential: { title: 'Notwendige Cookies' } }}
/>

Policy links

Translations may contain a flat <cookiePolicy>label</cookiePolicy> placeholder. Your application supplies the destination through cookiePolicyUrl:

<Banner
  isOpen
  cookiePolicyUrl="/cookies"
  bannerContent={{ collapsedText: 'Read our <cookiePolicy>Cookie Policy</cookiePolicy>.' }}
/>

The renderer creates a link for a usable destination, otherwise plain text. It does not inject arbitrary HTML. Unknown or malformed markup remains literal text.

Direct dictionaries

Import from @peax/consent-banner-locales/en or /de when you need one language directly. Install locales as a direct dependency when importing it in application code. Spread dictionaries to customize them; do not mutate shared defaults.

See locale exports.