Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@jsverse/transloco

jsverse443.8kMIT7.6.1TypeScript support: included

The internationalization (i18n) library for Angular

angular, angular 2, i18n, translate, angular translate, angular i18n, transloco

readme

[!IMPORTANT]
The Transloco packages are now published under the @jsverse scope, update your dependencies to get the latest features 🚀


The internationalization (i18n) library for Angular

npm Bundle Size Downloads Build Status PRs

Transloco enables you to define translations for your content in multiple languages and seamlessly switch between them at runtime. With its robust API, managing translations becomes efficient and maintainable. Additionally, Transloco offers an array of plugins designed to enhance your development experience. Here's a quick look at its powerful features:

✅  Signal-based API
✅  Fully supports standalone components
✅  Clean and DRY templates
✅  Lazy Loading support
✅  Handle multiple languages simultaneously
✅  Flexible fallbacks for missing translations
✅  Comprehensive testing support
✅  Server-Side Rendering (SSR) compatibility
✅  Localization (L10N) support
✅  A variety of rich plugins
✅  Highly customizable and hackable
✅  Schematics

Transloco is your all-in-one solution for internationalizing Angular applications with ease and flexibility.


  • 🤓  Explore the (brand new ✨) documentation to learn more.
  • 🚀  Check out the Sandbox & Examples to see Transloco in action.
  • 😎  Leverage Schematics for streamlined setup and configuration.
  • 📖  Dive into insightful blog posts.
  • ❓  Find answers to common questions in our FAQs.

Contributors ✨

Thank goes to all these wonderful people who contributed ❤️

changelog

7.6.1 (2025-03-24)

🩹 Fixes

  • transloco: 🐛 ngDevMode declaration issue (#843)

7.6.0 (2025-03-22)

🚀 Features

  • transloco: 🎸 Add a translateSignal (#838)

🩹 Fixes

  • transloco: complete subjects when root view is removed (#822)

7.5.1 (2024-12-24)

🩹 Fixes

  • transloco: 🐛 Remove flat as dependency (0730fd5f)

7.5.0 (2024-09-17)

🚀 Features

  • transloco: add option to not change the casing of the provided scope (fdcf536d)

7.4.4 (2024-09-16)

Bug Fixes

  • transloco: 🐛 Fixed file matching on Windows OS (71aade96)

7.4.3 (2024-07-26)

Features

  • transloco: 🎸 Schematics move to transloco.config.ts (fc4fc6b7)

7.4.2 (2024-05-31)

7.4.1 (2024-05-10)

Bug Fixes

  • transloco: 🐛 selectTranslate lang should support arrays (a77c79c)

7.4.0 (2024-05-01)

Features

  • transloco: 🎸 support nested objects in params (57b58f1), closes #652

7.3.0 (2024-04-25)

Features

  • transloco: 🎸 Expose default handlers (05c2ec1), closes #772

7.2.1 (2024-04-22)

7.2.0 (2024-04-19)

Features

  • transloco: allow to provide multiple scopes via provideTranslocoScopes (#758) (623b46f)

7.1.0 (2024-03-30)

Features

  • transloco: 🎸 introduce prefix input (1e27a8f)

7.0.0 (2024-03-23)

chore

  • transloco: 🤖 update package scope (f8b6d58)

Features

  • transloco: 🎸 Improve params algo matching (8447634)

BREAKING CHANGES

  • transloco: 🧨 The package is now published under the jsverse scope
  • transloco: 🧨 All breaking changes are listed in the breaking changes document

6.0.4 (2023-12-09)

Bug Fixes

  • transloco: 🐛 providing the FunctionalTranspiler (308438f), closes #733

6.0.3 (2023-12-09)

Bug Fixes

  • transloco: 🐛 export TranslocoOptions (396151f), closes #709

6.0.2 (2023-12-08)

6.0.1 (2023-12-05)

6.0.0 (2023-09-21)

BREAKING CHANGES

  • transloco: 🧨 Update to flat v6 which is ESM

5.0.10 (2023-09-20)

This version contains breaking changes, please use 5.0.7 until you are ready to migrate to v6.

  • transloco: 🐛 migrate schematic improve "translate" pipe regex (1d5cb65), closes #701
  • transloco: 🐛 split schematic doesn't update subfolders (841e2def), closes #695

BREAKING CHANGES

  • transloco: 🧨 Update to flat v6 which is ESM

5.0.9 (2023-09-17)

Bug Fixes

  • transloco: 🐛 split scope schematics (dfc5373), closes #558

This version contains breaking changes, please use 5.0.7 until you are ready to migrate to v6.

BREAKING CHANGES

  • transloco: 🧨 Update to flat v6 which is ESM

5.0.8 (2023-09-16)

Bug Fixes

This version contains breaking changes, please use 5.0.7 until you are ready to migrate to v6.

  • transloco: 🐛 update flat to v6 (7657b3d), closes #570

BREAKING CHANGES

  • transloco: 🧨 Update to flat v6 which is ESM

5.0.7 (2023-08-22)

Bug Fixes

  • transloco: 🐛 replace structuredClone with json clone (a76cd05), closes #688

5.0.6 (2023-08-05)

5.0.5 (2023-08-05)

Bug Fixes

  • transloco: 🐛 ng add in NgModule app (ad7f8bd5)

5.0.4 (2023-08-04)

Bug Fixes

  • transloco: 🐛 latest version not installed in fresh project (c8bb426)

5.0.3 (2023-08-02)

Bug Fixes

  • transloco: 🐛 allow multiple functions functional transpiler (#667) (5095f96)

5.0.2 (2023-07-31)

5.0.1 (2023-07-31)

Bug Fixes

  • transloco: 🐛 set transloco-utils dep version to 5 (#675) (0463090)

5.0.0 (2023-07-30)

Bug Fixes

  • transloco: 🐛 add missing provider + make environment (71d61d7)
  • transloco: 🐛 move to inject pattern and fix build (8f9fe59)
  • transloco: 🐛 multi scope handling (ec96ca6)

chore

Code Refactoring

  • transloco: 💡 remove type (2f61221)

Features

  • transloco: 🎸 upgrade to v16 (72381f5), closes #646
  • transloco: 🎸 upgrade to v16 and standalone (5f9e687)

BREAKING CHANGES

  • transloco: 🧨 Remove PersistStorage type
  • transloco: 🧨 Minimum Angular version is now 16
  • 🧨 Angular 16

4.3.0 (2023-06-10)

Bug Fixes

  • transloco: 🐛 providers typings (38e4981), closes #658

Features

  • transloco: 🎸 providers functions (528e548)

4.2.7 (2023-05-18)

4.2.6 (2023-03-04)

Bug Fixes

  • transloco: 🐛 fix message format delay (#634) (aa92418)

4.2.5 (2023-02-21)

Bug Fixes

  • transloco: update fs-extra and glob dependencies (#631) (e19057f)

4.2.4 (2023-02-19)

4.2.3 (2023-02-19)

Bug Fixes

  • transloco: 🐛 add missing schematics deps (581dda1), closes #623

4.2.2 (2023-01-06)

Bug Fixes

  • transloco: add overload type in selectTranslateObject method (#617) (071ca6b)

4.2.1 (2022-12-10)

Bug Fixes

  • transloco: 🐛 replace environment with isDveMode for v15 (e4bc6c91)

4.2.0 (2022-12-10)

Features

  • transloco: 🎸 add translation key to transpile method (#569) (3a19ba6), closes jsverse#568 Note: if you are using @jsverse/transloco-messageformat You'll need to update to 4.1.0 and above.

4.1.2 (2022-12-10)

Bug Fixes

  • schematics: set current directory as default project name (#582) (89b213f9)

4.1.1 (2022-07-13)

Bug Fixes

  • transloco: key as array in translateObject throws (#577) (5c8e90b)

4.1.0 (2022-06-04)

Features

  • transloco: 🎸 export translateObject as a proxy to the TranslocoService.translateObject method (#565) (26ef1a0)

4.0.0 (2022-03-23)

Features

  • transloco: 🎸 upgrade to v13 (d973668), closes #536

BREAKING CHANGES

  • transloco: 🧨 Minimum Angular version is now 13

3.2.0 (2022-03-19)

Features

  • transloco: 🎸 add langChanged event (50e374f)

3.1.4 (2022-02-15)

Bug Fixes

  • transloco: 🐛 Add generic type default to Translate<T>() (#545) (1a71d90)

3.1.3 (2022-01-22)

3.1.2 (2022-01-20)

Bug Fixes

  • transloco: 🐛 structural directive redundant calls (32230d6)

3.1.1 (2021-11-19)

Bug Fixes

  • transloco: 🐛 regular directive with ssr (28f14af)

3.1.0 (2021-11-09)

Features

  • transloco: 🎸 add a template context guard to directive (#526) (48f924d)

3.0.7 (2021-10-28)

3.0.6 (2021-10-14)

3.0.5 (2021-10-12)

Bug Fixes

  • transloco fallback strategy class is not decorated (#517) (e922982)

3.0.4 (2021-10-12)

3.0.3 (2021-10-10)

Bug Fixes

  • transloco: 🐛 fix schematics (627a565), closes #516

3.0.2 (2021-10-07)

Bug Fixes

  • transloco: 🐛 unexpected peerDependencies (672e529), closes #513

3.0.1 (2021-10-02)

3.0.0 (2021-09-30)

Bug Fixes

  • 🐛 don't call the missing handler when given an empty key (86fa12d)

Features

  • 🎸 supported passing params when reusing keys (6db0d74), closes #259
  • messageformat: 🎸 add cache support (773bc5c), closes #358

2.23.3 (2021-09-19)

Bug Fixes

Tests

2.23.2 (2021-09-13)

Bug Fixes

  • 🐛 load error not reported (cd92b46), closes #290
  • 🐛 static lang is ignored in pipe (28833b8), closes #463
  • 🐛 support optional chaining (e8e92ba), closes #488

2.23.1 (2021-09-11)

Bug Fixes

  • 🐛 ng-add wrong environment path (75d4bd0), closes #332

2.23.0 (2021-09-07)

Bug Fixes

Features

  • add possibility of override getTranslateFn (#492) (7b49bbd)

2.22.0 (2021-07-01)

Features

2.21.0 (2021-05-26)

Bug Fixes

  • 🐛 update angular peer dep (6b96f12)
  • directly specify location of package.json missing i18n config (#401) (54ee98a)

Features

  • locale: support default currency config (#423) (463b170)

2.20.1 (2021-02-28)

Bug Fixes

2.20.0 (2020-12-17)

Bug Fixes

Features

2.19.3 (2020-12-06)

Bug Fixes

  • 🐛 update peer to support angular 11 (6f3f973), closes #378

2.19.2 (2020-12-01)

Bug Fixes

  • 🐛 schematics keys manager install, support yarn (d923542)
  • tests: fix failing unit and e2e tests (#361) (43ff362)

2.19.1 (2020-08-22)

Bug Fixes

  • 🐛 pipe key type in strict mode (faa58a5), closes #311
  • 🐛 select translation on lang change (f2e5415)

Tests

2.19.0 (2020-08-18)

Features

  • 🎸 Add interpolation to configuration (#330) (cf07bfc)

2.18.4 (2020-08-07)

Bug Fixes

  • 🐛 Put transloco.module in its own folder (#319) (b54be7e)

2.18.3 (2020-07-22)

Bug Fixes

  • 🐛 remove unused group naming in regex (0258c07), closes #313

2.18.2 (2020-07-16)

Bug Fixes

  • 🐛 add injectable decorator (94bb9ee)

2.18.1 (2020-07-16)

Bug Fixes

  • 🐛 export the functional transpiler (2fc1a4f)

2.18.0 (2020-07-16)

Features

  • 🎸 functional transpiler (d3c5262)

2.17.5 (2020-07-11)

Bug Fixes

  • 🐛 update keys manager installation to latest version (#308) (d6f6526)

2.17.4 (2020-07-07)

Bug Fixes

  • 🐛 angular cli installing old transloco version (79f8e10), closes #304
  • 🐛 Angular v10 BC fixes (84ad417)

2.17.3 (2020-06-28)

Bug Fixes

  • 🐛 Angular v10 BC fixes (84ad417)

2.17.2 (2020-06-04)

Bug Fixes

  • 🐛 getBrowserLang throws error when browser has no lang (52c86c0), closes #289

2.17.1 (2020-05-01)

Bug Fixes

  • 🐛 migration script throws error when no files found (db82974)

2.17.0 (2020-04-24)

Bug Fixes

  • 🐛 don't display loading template if translations were load (#273) (c9214ad)

Features

  • 🎸 support translating key-params map (b261688), closes #272

2.16.1 (2020-04-23)

2.14.0 (2020-03-14)

Features

  • 🎸 Add to missingHandler the translation's parameter(s) (#255) (73256ce)

2.13.5 (2020-03-01)

Bug Fixes

  • 🐛 ngx migration support new line in pipes (00f1eae), closes #244
  • 🐛 set fallback translation (ff34773), closes #232

2.13.4 (2020-02-29)

Bug Fixes

  • types: Add additional formatting options (#247) (05b6d79)
  • 🐛 update peed dependencies (a1a813a)

2.13.3 (2020-02-12)

2.13.2 (2020-02-03)

2.13.1 (2020-02-02)

Bug Fixes

  • 🐛 testing module should work with ivy (2a68be7)

2.13.0 (2020-01-25)

Features

  • 🎸 add support for getting config from path (31c180a)
  • 🎸 support inline loader for select translate (#225) (a2b1867)

2.12.3 (2020-01-01)

Bug Fixes

  • 🐛 same fallback lang should not load again (#211) (5498dee), closes #210

2.12.2 (2019-12-24)

Bug Fixes

  • 🐛 select translate object not working with scopes (32e1ad7), closes #207

2.12.1 (2019-12-12)

Bug Fixes

  • 🐛 deprecate provideTranslocoConfig (#198) (a8957d2)

2.12.0 (2019-12-11)

Bug Fixes

  • 🐛 pipe return empty string by default (#192) (156cd62)
  • 🐛 select translations with scope should listen to lang change (6031046)

Features

  • transloco: implement provideTranslocoConfig method (#196) (2a755ae), closes #195

2.11.2 (2019-12-09)

Bug Fixes

  • 🐛 pipe return empty string by default (#192) (156cd62)
  • 🐛 select translations with scope should listen to lang change (6031046)

2.11.1 (2019-12-07)

Bug Fixes

  • 🐛 select translations with scope should listen to lang change (6031046)

2.11.0 (2019-12-06)

Bug Fixes

  • 🐛 preSaveTranslation should get the flattend object (9174141), closes #145
  • 🐛 schematics scope useValue type (2a2873c)
  • export TranslocoMissingHandlerData (#174) (c32d589)
  • Provide multiple values for TRANSLOCO_SCOPE to support lazy loading multiple json files (#184) (fa11baa)

Features

  • 🎸 add inline loader flag to scope (#175) (8c1383e)
  • 🎸 schmeatics:join support ignore/include default lang (7e48271)

2.10.0 (2019-12-03)

Bug Fixes

  • 🐛 preSaveTranslation should get the flattend object (9174141), closes #145
  • 🐛 schematics scope useValue type (2a2873c)
  • export TranslocoMissingHandlerData (#174) (c32d589)

Features

  • 🎸 add inline loader flag to scope (#175) (8c1383e)

2.9.0 (2019-11-27)

Features

  • 🎸 add inline loader flag to scope (#175) (8c1383e)

2.8.0 (2019-11-26)

Features

  • 🎸 pass scope name to loader (c32b10c)

2.7.0 (2019-11-25)

Bug Fixes

  • 🐛 ng-add: skip translation files creation if exist (#163) (a9c1bcf)
  • 🐛 remove missing keys warnings in tests (#169) (741d356)

Features

  • access to active language and up-to-date config in MissingHandler (#167) (30af5c5), closes #164

2.6.2 (2019-11-23)

Bug Fixes

  • 🐛 remove missing keys warnings in tests (#169) (741d356)

2.6.1 (2019-11-20)

Bug Fixes

  • 🐛 ng-add: skip translation files creation if exist (#163) (a9c1bcf)

2.6.0 (2019-11-17)

Features

  • 🎸 add schematics migration script from angular (#151) (bc07dfa)
  • 🎸 allow changing the fallback languages dynamically (2719981)

2.5.2 (2019-11-05)

Bug Fixes

  • 🐛 remove default langs (d9b6b26)

2.5.1 (2019-11-05)

Bug Fixes

2.5.0 (2019-11-05)

Bug Fixes

  • 🐛 schematics scope ignore routing.module file (57dbcd5)

Features

  • 🎸 inline-loader support any kind of promise (34bc788)
  • 🎸 schematics command to install keys manager (38c885b)

2.4.0 (2019-11-01)

Features

  • 🎸 add scope to event payload (f70db69)

2.3.1 (2019-10-30)

Bug Fixes

  • 🐛 predavetranslation should always be flat (2f12e71), closes #145

2.3.0 (2019-10-25)

Features

  • 🎸 add logMissingKey option to missing handler (c2d368b)

2.2.2 (2019-10-21)

Bug Fixes

  • 🐛 remove redundant dep (dad9269)

2.2.1 (2019-10-17)

Bug Fixes

  • 🐛 protect unsubscribing in pipe (b55bd59), closes #137

2.2.0 (2019-10-14)

Features

  • 🎸 add merge translation files command (28f1af9)
  • 🎸 add spill schematics command (f3ad130)
  • 🎸 inline loaders (1648de4)

Tests

  • 💍 schematics spill command (d57fa82)
  • 💍 test schematics merge command (5484520)

2.1.2 (2019-10-11)

Bug Fixes

  • 🐛 inline lang for pipe (72082c0)

Tests

  • 💍 refactor and add specs (ae7210a)

2.1.1 (2019-10-05)

Bug Fixes

  • 🐛 add key prefix when translating scope (#116) (a84ceb3)

2.1.0 (2019-10-04)

Features

  • 🎸 alias pr merge fix (7e3ab3f)

2.0.4 (2019-10-04)

Bug Fixes

  • 🐛 fix type in the structural directive (3144b51)

Tests

  • 💍 fix messageformat spec (eebd8a4)

2.0.3 (2019-10-03)

2.0.2 (2019-10-03)

Bug Fixes

  • 🐛 fix v2 upgrade script (e390ae4)

2.0.1 (2019-10-02)

Bug Fixes

  • 🐛 missing handler fix allow empty values in pipe (2efbe6c)

2.0.0 (2019-10-02)

Bug Fixes

  • 🐛 ng-add: fix hard coded fallbackLang (#90) (9b1239f)
  • schematics ng-add availabeLangs (8b6424d)

Features

  • 🎸 change structural to function (1945686)
  • 🎸 missing translation fallback (8151c24)
  • 🎸 v2 changes (430fadf)
  • 🤖 Add schematics for transloco scope (#79) (aea9495)

Tests

BREAKING CHANGES

  • See in BREAKING_CHANGES.md file

1.7.9 (2019-09-17)

1.7.8 (2019-09-11)

Bug Fixes

  • 🐛 update migration script (c7510f7)

1.7.7 (2019-09-11)

Bug Fixes

  • testing: set prodmode to true by default (5995b75)

1.7.6 (2019-09-09)

Bug Fixes

  • 🐛 allow pass config in testing module (caeaa8c)

1.7.5 (2019-09-08)

Bug Fixes

  • core: lack of unsubscriptions (#65) (67f5d3f)
  • 🐛 pipe should support any type (bf3f11c), closes #70

1.7.4 (2019-09-07)

Bug Fixes

1.7.3 (2019-09-06)

Bug Fixes

  • 🐛 transpiler protection (9471f17)

1.7.2 (2019-09-05)

Bug Fixes

  • 🐛 update migration script (b712bd7)

1.7.1 (2019-09-03)

Bug Fixes

1.7.0 (2019-09-01)

Bug Fixes

  • remove extension from missing handler export (e756079)
  • readme: add missing @ (#51) (2216378)

Features

1.6.0 (2019-08-28)

Features

  • limit nested translations (71e5488)
  • directive: add limit property (7715deb)
  • directive: add limit property (f17f417)
  • directive: read nested property (b51359e)
  • directive: set context to a nested property (561cba4)

1.5.0 (2019-08-28)

Bug Fixes

Features

Tests

1.4.2 (2019-08-27)

Bug Fixes

  • 🐛 message-format (ff835c3), closes #40
  • 🐛 migration script support for get function (67e112d)
  • 🐛 translate (620b151), closes #40

1.4.1 (2019-08-27)

Bug Fixes

  • 🐛 message-format (ff835c3), closes #40
  • 🐛 migration script support for get function (67e112d)
  • 🐛 translate (620b151), closes #40

1.4.0 (2019-08-27)

Bug Fixes

  • 🎸 support using ng-add for libraries (8ba6f25)
  • 🐛 global scoep translations in pipe and directive (c4d0993)
  • 🐛 global scope might not be loaded when sharing scope (d094764)
  • api: expose helpers and types (19e1a7f)

Features

  • 🎸 scope strategy - shared (84eb7ec)

Tests

  • 💍 finish testing (104ecd3)
  • 💍 fix cypress specs (7fdfe11)
  • 💍 shared scope - update specs (50f3362)

1.3.0 (2019-08-26)

Bug Fixes

  • 🐛 global scoep translations in pipe and directive (c4d0993)
  • 🐛 global scope might not be loaded when sharing scope (d094764)

Features

  • 🎸 scope strategy - shared (84eb7ec)

Tests

  • 💍 finish testing (104ecd3)
  • 💍 fix cypress specs (7fdfe11)
  • 💍 shared scope - update specs (50f3362)

1.2.0 (2019-08-23)

Bug Fixes

  • 🐛 fix format message import (f8815dc)
  • 🐛 schematics ng-add import-default bug (#29) (35229e0)

Build System

  • add peerDependencies to package.json (22b0af5)

Features

  • lib: 🎸 add messageformat support through custom transpiler (#11) (1feb309)
  • 🎸 added ssr question to ng-add (#30) (7bcd15d)
  • 🎸 lib (ab5a6fb)

1.1.3 (2019-08-22)

Bug Fixes

  • 🐛 fix format message import (f8815dc)
  • 🐛 schematics ng-add import-default bug (#29) (35229e0)

Build System

  • add peerDependencies to package.json (22b0af5)

Features

  • 🎸 added ssr question to ng-add (#30) (7bcd15d)
  • lib: 🎸 add messageformat support through custom transpiler (#11) (1feb309)

1.1.2 (2019-08-22)

Bug Fixes

  • 🐛 fix format message import (f8815dc)
  • 🐛 schematics ng-add import-default bug (#29) (35229e0)

Build System

  • add peerDependencies to package.json (22b0af5)

Features

  • 🎸 added ssr question to ng-add (#30) (7bcd15d)
  • lib: 🎸 add messageformat support through custom transpiler (#11) (1feb309)

1.1.0 (2019-08-16)

Features

  • lib: 🎸 add messageformat support through custom transpiler (#11) (1feb309)

1.0.0 (2019-08-16)

Bug Fixes

  • 🐛 fix ngx-translate migration script (dfe47bf)
  • 🐛 get value function (2a9d0a4)
  • 🐛 migration script special chars (9f9a917)
  • 🐛 missing dependencies, angular schematics path (fb94489)
  • 🐛 missing handler should return the missing key (05297f1)
  • 🐛 service load issues (82b9321)
  • 🐛 update dependencies (530bb30)
  • migration: fix script (6fc9e7b)
  • query: fix query params getter (63a8224)
  • schematics: ng-add schematics fixes (#35) (10d4146)
  • schematics: when the user chose http as loader add HttpClien… (#54) (66b07f6)
  • schematics: when the user chose http as loader add HttpClientModule (e5e0766)
  • transloco-service: pr fixes (4f276d1)
  • fix tests (fc841bd)
  • handle parser error when couldn't parse (a016030)

Build System

  • lock file: update lock file (f410e17)

Features

  • schematics: added generator for transloco component (#61) (82d8df3)
  • schematics: added ng-add schematics command (#32) (71c53f1)
  • schematics: support project in ng-add (#5) (3fbdd41)
  • specs: add cypress (a2605dc)
  • specs: add specs coverage (7016f88)
  • transloco-pipe: support providerLang (bc3e809)
  • transloco-service: dependentless translate (9ad22ad)
  • transloco-service: getTranslation should support get all (e12e5f6), closes #58
  • transloco-service: support multiple fallback langs (0e630bc), closes #40
  • transloco-service: support translating using a callback (067ad98), closes #56
  • added global loading template token (e4a87eb)
  • added global loading template token (#55) (34183dd)
  • added setTranslation && setTranslationKey methods (fdf2ade)
  • added support for multi key translation (#46) (15378c5)
  • lazy load (6dc1f72)
  • lazy load (ee68219)

Tests