Multi-Language

CookieBoss supports multiple languages for your consent banner. The banner detects the visitor’s browser language and shows the matching translation.

How language detection works

  1. CookieBoss reads the browser’s navigator.language (e.g. de-DE)
  2. It tries to match the language code (e.g. de) against your configured languages
  3. If no match is found, it falls back to your default language

ConsentTexts interface

Each language has the following text fields:

Name Type Required Default Description
headline string Yes - Banner title (e.g. 'We use cookies')
body string Yes - Banner description text
acceptAllLabel string Yes - Accept All button text
rejectAllLabel string Yes - Reject All button text
manageLabel string Yes - Customize/Manage button text
saveLabel string Yes - Save Preferences button text
categories.necessary.label string Yes - Necessary category label
categories.necessary.description string Yes - Necessary category description
categories.analytics.label string Yes - Analytics category label
categories.analytics.description string Yes - Analytics category description
categories.marketing.label string Yes - Marketing category label
categories.marketing.description string Yes - Marketing category description
categories.functional.label string Yes - Functional category label
categories.functional.description string Yes - Functional category description

Adding a language in the dashboard

  1. Open the Banner Editor for your site
  2. Navigate to the Text tab
  3. Select a language from the dropdown or add a new language
  4. Fill in all text fields
  5. Save and Publish

Managing languages via API

Get texts for a language

GET /api/v1/sites/:siteId/config/texts/:language

Update texts for a language

PUT /api/v1/sites/:siteId/config/texts/de json 
{
"headline": "Wir verwenden Cookies",
"body": "Wir nutzen Cookies, um Ihnen die bestmögliche Erfahrung auf unserer Website zu bieten.",
"acceptAllLabel": "Alle akzeptieren",
"rejectAllLabel": "Alle ablehnen",
"manageLabel": "Einstellungen",
"saveLabel": "Einstellungen speichern",
"categories": {
  "necessary": {
    "label": "Notwendig",
    "description": "Diese Cookies sind für die Grundfunktionen der Website erforderlich."
  },
  "analytics": {
    "label": "Analyse",
    "description": "Diese Cookies helfen uns zu verstehen, wie Besucher unsere Website nutzen."
  },
  "marketing": {
    "label": "Marketing",
    "description": "Diese Cookies werden verwendet, um Ihnen relevante Werbung zu zeigen."
  },
  "functional": {
    "label": "Funktional",
    "description": "Diese Cookies ermöglichen erweiterte Funktionen und Personalisierung."
  }
}
}

Default language

Set the defaultLanguage in your site configuration. This is used when the visitor’s browser language doesn’t match any configured language.

Start with English

We recommend configuring English (en) first as the default, then adding translations for your target markets. This ensures all visitors see a usable banner even if their specific language isn’t configured.