Skip to content

Documentation

Configure Banner Texts & Languages

Configure Banner Texts & Languages

Last updated Mar 24, 2026

Kukie.io supports over 70 built-in languages with auto-translation, so your cookie banner can greet every visitor in their own language. You can also provide custom translations - including cookie category names and descriptions - to match your tone of voice exactly.

The Texts Tab

In the Banner Editor, switch to the Texts tab. Here you can edit the default text fields displayed on your banner:

  • Banner title - the heading shown at the top of the banner (e.g. "We use cookies").
  • Banner description - the paragraph explaining why you use cookies and what happens when the visitor consents.
  • Button labels - Accept All, Reject All, Manage Preferences, and Save Preferences.
  • Privacy policy link text & URL - the label and URL for the link to your privacy policy. Can be set per language for localised policy pages.
  • Cookie policy link text & URL - the label and URL for the link to your cookie policy.
  • Cookie detail labels - Provider, Duration, and Description column headers shown in the cookie details table.
  • No cookies detected text - the message shown when a category has no cookies listed.

Category Texts

Below the banner text fields, the Category Texts section lets you customise the name and description for each cookie category (Essential, Functional, Analytics, Marketing). These appear in the preferences modal when visitors expand a category to learn more.

Each category has two editable fields:

  • Name - the category title shown in the preferences list (e.g. "Analytics" or "Statistiken").
  • Description - a short explanation of what the category covers and why the cookies are used.

When you add a new language and use Auto-Translate, these fields are pre-filled with the built-in translation for that language. You can then adjust the wording as needed. If you leave a field empty, the built-in translation is used automatically.

Tip: Use the category descriptions to explain in plain language what each cookie category does. Visitors are more likely to accept cookies when they understand the purpose.

Default Language

The Default language dropdown sets the fallback language used when the visitor's preferred language is not available. This is the last step in the language detection chain.

Language Detection Order

The banner script detects language in the following priority order:

  1. data-lang attribute on the script tag - an explicit override for developers.
  2. <html lang="..."> attribute - the page content language, ideal for multilingual sites with WPML or Polylang.
  3. navigator.language - the visitor's browser language.
  4. The default language configured here.

Auto-Translate

Enable the Auto-translate toggle to activate built-in translations. When enabled, the banner automatically displays text in the visitor's detected language using Kukie.io's 70+ built-in translations - including all banner fields and category names and descriptions. You can still override any individual string with a custom translation - custom text always takes priority over the built-in version.

Tip: Even with auto-translate enabled, review the translations for your primary markets. Built-in translations cover all text fields, but you may want to adjust the banner description or category texts to match your specific cookie usage.

Custom Translations

To add or edit a translation for a specific language:

  1. Enable the language in the Enabled Languages list.
  2. Click the language to expand its text fields.
  3. Fill in any fields you want to customise - including banner text, button labels, and category names and descriptions.
  4. Leave fields blank to use the built-in translation for that string.

You can customise as many or as few fields as you like per language. The banner merges your custom text with the built-in translation, so every field is always filled.

Pre-filled Translations

When you add a new custom language, all fields - including category names and descriptions - are automatically pre-filled with the built-in translation for that language. This saves you from starting with blank fields and gives you a ready-made translation to review and adjust.

RTL Support

Kukie.io automatically enables right-to-left (RTL) text direction for Arabic, Farsi, Hebrew, and Urdu. When one of these languages is detected, the banner applies dir="rtl" and adjusts text alignment, button order, and toggle positioning.

No extra configuration is needed - RTL support is fully automatic based on the detected language.

Was this helpful?