--- url: https://docs.comnto.com/customization/localization.md description: >- Choosing one of 22 bundled locales, overriding UI phrases, forcing LTR/RTL direction, and handling multilingual pages. --- # Localization & Direction The widget can speak the same language as the rest of your site and respect right-to-left layouts. ## Pick a language Comnto ships with localisation bundles for the following locales: `ar`, `de`, `en`, `es`, `fa`, `fr`, `he`, `hi`, `id`, `it`, `ja`, `ko`, `nl`, `pl`, `pt`, `ru`, `sv`, `tr`, `uk`, `vi`, `zh`, `zh-TW` Use whichever form suits you best: * `data-locale="fr"` * `window.comnto({ site: 'my-blog', locale: 'fr' })` * `widget.setLocale('fr')` If you omit the locale, the widget falls back to the page `` attribute or the site default stored in Comnto. ## Custom phrases Provide overrides with the `localization` option. You can deliver either a single-locale object or a map of locale codes. ```js window.comnto({ el: '#comments', site: 'my-blog', locale: 'en', localization: { en: { heading: { title: 'Discussion' }, noComments: { title: 'Be the first to comment' } } } }); ``` At runtime you can refine copies without reloading the iframe: ```js widget.setLocalization({ ar: { heading: { title: 'التعليقات' } } }); ``` ## Direction (LTR / RTL) The widget automatically switches to RTL when the locale uses a right-to-left script (Arabic, Hebrew, Persian, etc.). You can override the direction manually: ```js widget.setDirection('rtl'); // or 'ltr' / 'auto' ``` When you call `setDirection`, the widget updates the root `` attribute inside the iframe. ## Mixed-language pages For multilingual pages: 1. Mount one widget per language by passing the desired locale (and site id) in each `window.comnto()` call. 2. If you dynamically switch languages, call `widget.setLocale(newLocale)` and re-send the relevant overrides with `widget.setLocalization()`.