Skip to main content
Version: 5.x.x

Installation (Angular)

Check our Angular example application

To install Tolgee Angular integration library, run the following:

npm install @tolgee/ngx

Then import NgxTolgeeModule in your module file (app.module.ts or other):

import {
} from '@tolgee/ngx';
declarations: [
imports: [
providers: [
useFactory: () => {
return Tolgee()
language: 'en'

// for development
apiUrl: environment.tolgeeApiUrl,
apiKey: environment.tolgeeApiKey,

// for production
staticData: {
bootstrap: [AppComponent],
export class AppModule {}

Check all tolgee options and tolgee plugins.

So you have to:

  1. Add NgxTolgeeModule to your import section
  2. Add Factory provider for TOLGEE_INSTANCE token returning your Tolgee instance.

Use angular application environments to configure apiUrl and apiKey.

Preparing for production

Tolgee will automatically omit DevTools from your bundle when you build your app for production. So it won't fetch translations directly from Tolgee Platform and it won't allow users to modify translations.

There are generally two ways how to use translations in production:

In production mode, you should never use localization data directly from Tolgee REST API, because it can negatively affect your page performance.