> For the complete documentation index, see [llms.txt](https://jsverse.gitbook.io/transloco/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jsverse.gitbook.io/transloco/getting-started/config-options.md).

# Config Options

<details>

<summary>Complete config example</summary>

This is the default configuration that's being set via the ng-add schematic:

```typescript
translocoConfig({
  availableLangs: ['en', 'es'],
  defaultLang: 'en',
  // Remove this option if your application doesn't support changing language in runtime.
  reRenderOnLangChange: true,
  prodMode: !isDevMode(),
});
```

There are more advanced options you can use to fine-tune Transloco to your needs. Here is a complete example showcasing all these options—you can read more about each one on this page.

```typescript
translocoConfig({
  availableLangs: ['en', 'es'],
  defaultLang: 'en',
  // Remove this option if your application doesn't support changing language in runtime.
  reRenderOnLangChange: true,
  prodMode: !isDevMode(),
  fallbackLang: 'es', // ['en', 'ru'],
  failedRetries: 1,
  missingHandler: {
    allowEmpty: true,
    useFallbackTranslation: true,
    logMissingKey: isDevMode(),
  },
  flatten: {
    aot: !isDevMode(),
  },
  interpolation: ['<<<', '>>>'],
  scopes: {
    keepCasing: false,
  },
});
```

</details>

## **`reRenderOnLangChange`**

For applications that don't allow users to change the language dynamically (e.g., via a dropdown), set this to `false`. This will save memory by rendering the view once and unsubscribing from the language change event. (Defaults to `false`.)

```typescript
translocoConfig({
  reRenderOnLangChange: boolean,
});
```

## **`defaultLang`**

Sets the default language for the application. (Defaults to `'en'`.)

```typescript
translocoConfig({
  defaultLang: 'en',
});
```

## **`fallbackLang`**

Defines one or more fallback languages to use when a translation is unavailable. See the **TranslocoFallbackStrategy** section for customization options.

```typescript
translocoConfig({
  fallbackLang: 'en',
  fallbackLang: ['en', 'ru'],
});
```

## **`failedRetries`**

Specifies the number of retries for loading translation files in case of failure. (Defaults to `2`.)

```typescript
translocoConfig({
  failedRetries: 1,
});
```

## **`prodMode`**

Indicates whether the application is running in production mode. (Defaults to `false`.) When enabled, Transloco will disable all console warnings.

```typescript
import { isDevMode } from '@angular/core';

translocoConfig({
  prodMode: !isDevMode(),
});
```

## **`availableLangs`**

Lists the available languages in your application.

```typescript
translocoConfig({
  availableLangs: ['en', 'es'],
});
```

## **`missingHandler.allowEmpty`**

Specifies whether to allow empty values when a translation is missing. (Defaults to `false`.)

```typescript
translocoConfig({
  missingHandler: {
    allowEmpty: true,
  },
});
```

## **`missingHandler.useFallbackTranslation`**

Determines whether to use the fallback language for missing keys or values. (Defaults to `false`.)

```typescript
translocoConfig({
  fallbackLang: 'en',
  missingHandler: {
    useFallbackTranslation: true,
  },
});
```

## **`missingHandler.logMissingKey`**

Specifies whether to log a warning to the console when a translation key is missing. (Defaults to `true`.)

```typescript
translocoConfig({
  missingHandler: {
    logMissingKey: false,
  },
});
```

## **`flatten.aot`**

Check the optimization plugin for Ahead-of-Time (AOT) compilation.

```typescript
import { isDevMode } from '@angular/core';

translocoConfig({
  flatten: {
    aot: !isDevMode(),
  },
});
```

## **`interpolation`**

Defines the start and end markers for parameters in translations. (Defaults to `['{{', '}}']`.)

```typescript
translocoConfig({
  // This allows specifying parameters like: `"Hello <<<value>>>"`
  interpolation: ['<<<', '>>>'],
});
```

## **`scopes.keepCasing`**&#x20;

Ensures that the casing of the scope name is preserved unless an alias has been set. If no alias is set, this option will be ignored.

```typescript
translocoConfig({
  scopes: {
    keepCasing: false,
  },
});
```

***

This version aims to clarify the purpose of each option and maintain a consistent style for code examples.