# nestjs-i18n

> The i18n module for Nest.

Latest version **10.8.5** (published 2026-07-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install nestjs-i18n
pnpm add nestjs-i18n
yarn add nestjs-i18n
bun add nestjs-i18n
```

Provides the command `nestjs-i18n`.

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 10.8.5 |
| Published | 2026-07-07 |
| First published | 2019-03-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=22 |
| Dependencies | 5 |
| Unpacked size | 264.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 723 |
| Author | Toon van Strijp |
| Maintainers | toonvanstrijp, rubins |
| Keywords | i18n, international, internationalisation, internationalise, internationalization, internationalize, locale, nestjs |

## Links

- npm: https://www.npmjs.com/package/nestjs-i18n
- Repository: https://github.com/ToonvanStrijp/nestjs-i18n
- Homepage: https://nestjs-i18n.com
- Issues: https://github.com/ToonvanStrijp/nestjs-i18n/issues
- npm.io page: https://npm.io/package/nestjs-i18n

## Dependencies (5)

- [yaml](https://npm.io/package/yaml.md) ^2.8.3
- [cookie](https://npm.io/package/cookie.md) ^1.1.1
- [chokidar](https://npm.io/package/chokidar.md) ^3.6.0
- [string-format](https://npm.io/package/string-format.md) ^2.0.0
- [@messageformat/core](https://npm.io/package/@messageformat/core.md) ^3.4.0

## Alternatives

- [messageformat](https://npm.io/package/messageformat.md) — 329.7K weekly downloads
- [@mintlify/scraping](https://npm.io/package/@mintlify/scraping.md) — 294.8K weekly downloads
- [@mintlify/previewing](https://npm.io/package/@mintlify/previewing.md) — 209.5K weekly downloads
- [@mintlify/prebuild](https://npm.io/package/@mintlify/prebuild.md) — 209.5K weekly downloads
- [@mintlify/link-rot](https://npm.io/package/@mintlify/link-rot.md) — 206.3K weekly downloads

## Recent versions

- 10.8.5 (latest) — 2026-07-07
- 11.0.0-beta (beta) — 2024-04-25
- 10.2.7-rc.1 (next) — 2023-06-27
- 10.8.4 — 2026-05-02
- 10.8.3 — 2026-04-28
- 10.8.2 — 2026-04-28
- 10.8.1 — 2026-04-26
- 10.8.0 — 2026-04-24
- 10.7.5 — 2026-04-22
- 10.7.3 — 2026-04-22
- 10.7.2 — 2026-04-21
- 10.7.1 — 2026-04-21
- 10.7.0 — 2026-04-18
- 10.6.5 — 2026-04-17
- 10.6.2 — 2026-04-16
- … 121 more at https://npm.io/package/nestjs-i18n/versions

## README

<p align="center">
  <a href="https://nestjs-i18n.com/" target="_blank"><img src="https://nestjs-i18n.com/img/logo.svg" width="600" alt="nestjs-i18n Logo" /></a>
</p>
<p align="center">
  The i18n library for <a href="https://nestjs.com" target="_blank">nestjs</a>. It makes working with languages in your nestjs project easy. Everything is made to be highly configurable. You can write and plug-in your own language resolvers or loaders.
  <p align="center">
    <a href="https://www.npmjs.com/package/nestjs-i18n" target="_blank"><img alt="npm version" src="https://img.shields.io/npm/v/nestjs-i18n" /></a>
    <a href="https://www.npmjs.com/package/nestjs-i18n" target="_blank"><img alt="NPM" src="https://img.shields.io/npm/l/nestjs-i18n" /></a>
    <a href="https://github.com/toonvanstrijp/nestjs-i18n/actions/workflows/test.yaml" target="_blank"><img src="https://github.com/toonvanstrijp/nestjs-i18n/actions/workflows/test.yaml/badge.svg?branch=main" /></a>
    <a href="https://www.npmjs.com/package/nestjs-i18n" target="_blank"><img alt="npm downloads" src="https://img.shields.io/npm/dm/nestjs-i18n" /></a>
     <a href="https://coveralls.io/github/toonvanstrijp/nestjs-i18n?branch=main" target="_blank"><img alt="coverage" src="https://coveralls.io/repos/github/toonvanstrijp/nestjs-i18n/badge.svg?branch=main" /></a>
  </p>
</p>

## Features

**nestjs-i18n** comes with a bunch of tools to help add multiple language support to your project.

- **Type safety** 🎉 ([instructions](https://nestjs-i18n.com/guides/type-safety))
- **Variable formatting** ([instructions](https://nestjs-i18n.com/guides/formatting))
- **Fallback** languages ([instructions](https://nestjs-i18n.com/guides/fallback-languages))
- **Live** reloading 🎉
- **Plurals** support ([instructions](https://nestjs-i18n.com/guides/plurals))
- **GraphQL** support ([instructions](https://nestjs-i18n.com/guides/graphql))
- **gRPC** support ([instructions](https://nestjs-i18n.com/guides/grpc))
- **DTO** validation ([instructions](https://nestjs-i18n.com/guides/dto_validation/global-validation))
- View engine support ([**hbs**](https://nestjs-i18n.com/guides/view_engines/handlebars) or [**pug**](https://nestjs-i18n.com/guides/view_engines/pug) or [**ejs**](https://nestjs-i18n.com/guides/view_engines/ejs))
- Custom resolvers
- Custom loaders
- Custom formatters

## Getting started

To get started follow the [**quickstart**](https://nestjs-i18n.com/quick-start), or take a look at the [**docs**](https://nestjs-i18n.com/). 

## License

`nestjs-i18n` is MIT licensed.

## Breaking changes:
- from V10.0.0 on we removed the `I18nRequestScopeService`. This because we now have `async_hooks` support. This allows you to get the current `I18nContext` by doing `I18nContext.current()`.

- from V9.0.0 on we renamed the `parser` property to `loader`. The `translate` function no longer returns a promise 🎉. A lot of new features and new docs, see [nestjs-i18n.com](https://nestjs-i18n.com/).

- from V8.0.0 on we changed the internal `I18n-middleware` for an `interceptor` this way we can provide the `ExecutionContext` so that `nestjs-i18n` works on different protocols as well, such as gRPC and WebSockets. This contains one breaking change. It only applies to your code if you've made a custom `resolver`. To resolve this breaking change take a look at this [example](https://nestjs-i18n.com/concepts/resolver). Instead of providing the `req` in the `resolve` method, change this to take the `ExecutionContext` as argument.

- from V6.0.0 on we implemented the `I18nParser`, by using this we can easily support different formats other than JSON. To migrate to this change look at the [quickstart](https://nestjs-i18n.com/quick-start). There are some changes in the declaration of the `I18nModule`. Note: the `translate` function returns a `Promise<string>`. So you need to call it using `await i18n.translate('HELLO')`;

- from V4.0.0 on we changed the signature of the `translate` function, the `language` is now optional, if no `language` is given it'll fallback to the `fallbackLanguage`.

- from V3.0.0 on we load translations based on their directory name instead of file name. Change your translations files to the structure found in the [quickstart](https://nestjs-i18n.com/quick-start#setup-translation-files).

---
_Source: https://npm.io/package/nestjs-i18n · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._