Skip to main content

Multi-Language Support

topi supports multiple languages.

Language is detected automatically

topi's frontend applications detect the browser's locale and use it as the user's preferred language. If the browser's preferred language is German, the application is served in German. The user does not select a language in the UI.

topi's internationalisation system is based on language, not locale. Regional variants such as en-US and en-GB are both treated as English, not American English or British English. This may change in the future as regional differences matter more for sellers and customers.

Emails and Invoices are also localised

topi continually updates the browser locale in its database per seller, user, and customer. topi uses this locale to send emails and invoices in the expected language. Invoices are also formatted according to local regulatory requirements.

topi Elements is multi-language enabled

topi Elements is topi's first-party library for embedding custom elements directly into your store's frontend.

Pass the locale argument when initialising the library so the elements display text in the language your ecommerce customers expect. For more information, refer to topi Elements - initialize the library.


two screenshots of the topi Hosted Checkout, one in German and one in English