Skip to main content

Understanding Tolgee for Web

To work with Tolgee properly you should be familiar with basic Tolgee concepts.


Tolgee works in two modes: development and production.

Development mode

Users who access the page in development mode are able to change localization texts in context of the page. To achieve this, Tolgee needs to identify which text in DOM should be translated. Tolgee basically checks specific DOM subtree on every change and looks for translation keys wrapped in strings provided by configuration properties inputPrefix and inputSuffix. This is the reason why wrapped keys and params are returned from translate and instant functions in development mode.

Tolgee is in development mode when apiUrl + apiKey are defined and valid.

Production mode

On the contrary in production mode, translate and instant methods return the translated text directly. Tolgee is unable to change the occurrences anymore. When language changes, you should rerender every translated text manually. However, our integrations for React and Angular handle this out of the box.