Localization

The Embedded Portal ships with English and Spanish out of the box. You set a default for the project and can optionally override per-user.

Setting the default

In Settings → Embedded Portal:

• Default locale — used when no locale is supplied with the user payload.
• Supported locales — restrict which locales are accepted. The default locale must always be selected.

Per-user override

Pass locale either inside the signed identity payload or as a separate option to init:

window.UserHeroQueue.push(['init', {
    publicKey: 'YOUR_PUBLIC_KEY',
    user: userPayload,
    userHmac: userHmac,
    locale: 'es',
}]);

You can also change it at runtime — useful when your app's language switcher updates:

UserHero.setLocale('es');

If a locale is requested that isn't in the project's supported list, the portal falls back to the project default.

Right-to-left

RTL languages are not yet supported. We will add them as the locale list grows — let us know which locale you need next.