Widget multi-language support

Multi‑language widget

The Certorix widget can be localised into multiple languages. Language is auto‑detected from the customer's browser settings.

Supported languages

• English (en) – default
• Spanish (es)
• French (fr)
• German (de)
• Italian (it)
• Portuguese (pt)
• Dutch (nl)
• Polish (pl)
• Swedish (sv)
• Catalan (ca)

How language detection works

1. Widget reads Accept-Language header from the browser.
2. If the browser's preferred language matches any supported language, widget uses that language.
3. If no match, falls back to English.

Translating widget UI text

UI elements (buttons, labels, error messages) are automatically translated. You do not need to configure anything.

Example translations:

• English: 'Continue' → Spanish: 'Continuar' → French: 'Continuer'
• English: 'Contact us' → Spanish: 'Contáctanos' → French: 'Nous contacter'
• English: 'Submit' → Spanish: 'Enviar' → French: 'Envoyer'

Translating tree content

Tree content (questions, answers, solution messages) is not automatically translated. You must create separate trees per language.

Best practice: Create language‑specific trees (e.g., 'WiFi Troubleshooter EN', 'WiFi Troubleshooter ES'). Use the widget's language detection to serve the correct tree.

Language‑specific tree selection

In the Widget Generator, you can map languages to specific trees:

1. Under Language mapping, click Add mapping.
2. Select a language (e.g., Spanish).
3. Select the tree for that language.
4. Add mappings for other languages.
5. Default tree (fallback) is for English or when no mapping matches.

Overriding language detection

Force a specific language by adding ?lang=es to the direct link URL or widget embed configuration:

cw('init', { ... , language: 'es' });

This ignores browser settings and always shows Spanish.