Unblu 4.1

Selecting The Language To Use

1. Setting the Language / Locale

The locale describes the regional settings for a piece of software, such as a website, or unblu. The most noticeable aspect of the locale is the language in which the user interface is displayed, but the locale can contain other regional aspects (such as date formats, number formats, and so on).

If your website has only one locale, you can set that locale for unblu in the configuration. This ensures that the website and unblu use the same locale (that is, the same language and the same other regional settings).

If your website supports multiple locales, then you have to tell unblu which locale to use.

2. Using an Attribute

A very straightforward way of telling unblu which locale to use is by using the default html lang attribute in the <html> tag, as follows:


<html lang="en">


IMPORTANT: Although according to the html specification the lang attribute can be set on any tag, unblu only checks the html tag to pick up the language.

Unblu supports either language code or language-region code as defined in section 2.2.1 (Language), section 2.2.4 (Region) and Appendix A (examples for language-region). For more information see If you do not want to set the language for the entire page, you can tell unblu explicitly what locale to use. To do so, add the (custom) attribute unblu_locale to the html tag as follows:

<html unblu_locale="en-US"> 


Most content management systems will let you add this attribute to all pages with little effort.

3. Using a JavaScript Function Call

You can also use a JavaScript function call to set the locale, as follows:




Note that you have to call the function after the unblu snippet but before the page is rendered. If at all possible, we recommend that you place the call immediately after the snippet.

4. Languages and Regions

The language code follows the IETF convention for language codes, so the following calls set the locales for English, US-English, and German as spoken in Germany:

  • unblu.setLocale("en")
  • unblu.setLocale("en-US")
  • unblu.setLocale("de-DE")