---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../modules.md) / i18n

# i18n

Internationalization (i18n) support for B2C CLI tools.

This module provides translation utilities using i18next, with support for
multiple languages and environment-based language detection.

## Key Features

- Default strings are stored inline at point of use (no separate en.ts needed)
- TypeScript locale files for type safety and bundling
- Namespace separation: 'b2c' for tooling, 'cli' for CLI-specific messages

## Language Detection

Language is detected in this order:
1. Explicit [setLanguage](functions/setLanguage.md) call (from --lang flag)
2. `LANGUAGE` environment variable (GNU gettext standard)
3. `LANG` system environment variable (Unix standard)
4. Default: 'en'

## Supported Locale Formats

- `de` - simple language code
- `de_DE` - language with country
- `de-DE` - language with country (hyphen)
- `de_DE.UTF-8` - with encoding
- `de:en:fr` - colon-separated preference list (LANGUAGE only)

## Usage

```typescript
import { t } from '@salesforce/b2c-tooling-sdk';

// Simple translation with inline default
const message = t('error.serverRequired', 'Server is required.');

// With interpolation
const fileError = t('error.fileNotFound', 'File {{path}} not found.', {
  path: '/foo/bar'
});
```

## Adding Translations

```typescript
import { registerTranslations } from '@salesforce/b2c-tooling-sdk';

// Register translations for a new namespace
registerTranslations('my-package', 'de', {
  greeting: 'Hallo Welt'
});
```

## Type Aliases

- [TOptions](type-aliases/TOptions.md)

## Variables

- [B2C\_NAMESPACE](variables/B2C_NAMESPACE.md)

## Functions

- [getI18nInstance](functions/getI18nInstance.md)
- [getLanguage](functions/getLanguage.md)
- [registerTranslations](functions/registerTranslations.md)
- [setLanguage](functions/setLanguage.md)
- [t](functions/t.md)