Internationalization

The widget supports 9 locales out of the box. The locale is selected with data-locale (auto-init) or config.locale.

Supported locales

Code	Language	Loading
es	Spanish	eager (in the main bundle)
en	English	eager
fr	French	lazy
de	German	lazy
it	Italian	lazy
pt	Portuguese	lazy
ca	Catalan	lazy
eu	Basque	lazy
gl	Galician	lazy

es and en are included in the main bundle because they cover ~95 % of the current traffic. The other 7 locales are loaded in lazy chunks the first time a user activates the widget on that locale, keeping the initial bundle below 65 KB gzip.

Detection and fallback

1. The widget reads config.locale/data-locale.
2. If the value is not in SUPPORTED_LOCALES, it emits a console.warn and falls back to es.
3. Any missing key in a translation falls back to the English string (en acts as the base).

Example

<script
  src="https://cdn.neuroon.ai/widget@0.9.10/widget.js"
  data-token="WIDGET_TOKEN"
  data-container="#neuroon-search"
  data-locale="ca"
  async
></script>

window.NeuroonWidget.init({
  container: '#neuroon-search',
  token: 'WIDGET_TOKEN',
  locale: 'eu',
})

Custom translations

You can override any subset of keys via config.translations. They are merged on top of the active locale bundle (deep merge):

window.NeuroonWidget.init({
  container: '#neuroon-search',
  token: 'WIDGET_TOKEN',
  locale: 'es',
  translations: {
    search: {
      placeholder: 'Buscar en nuestra ferretería…',
      voiceButton: 'Buscar dictando',
    },
    results: {
      empty: 'No tenemos eso. ¿Quieres que te avisemos cuando llegue?',
    },
  },
})

AI assistant language

Widget translations control the UI. The conversational agent picks the response language based on the Accept-Language header and internal heuristics, returning the code in SearchResponse.responseLanguage. Normally it matches config.locale, but the agent may answer in the language detected in the query if it differs.

Switch locale at runtime

The current JavaScript API does not expose setLocale. To change the locale, destroy the instance and re-mount it with the new one:

const w = window.NeuroonWidget.getInstance('#neuroon-search')
w?.destroy()
window.NeuroonWidget.init({
  container: '#neuroon-search',
  token: 'WIDGET_TOKEN',
  locale: 'fr',
})

Further reading

• Configuration — translations and locale.
• Accessibility — localized screen reader announcements.
• Widget events — lifecycle events.