NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #2339 most downloaded on npm
i18next internationalization framework
Latest stable
27.2.2
Last release today
19 Nov 2026
Release timing varies
gaps range from 8 days to 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
641 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
feat(types): support typescript 6 to address https://github.com/i18next/react-i18next/issues/1910
feat(types): selector functions as keyPrefix in getFixedT now provide full type-safe key narrowing — the returned t function is scoped to the prefix s
keyPrefix in getFixedT now provide full type-safe key narrowing — the returned t function is scoped to the prefix subtree 2367feat(types): i18nKey of to accept a SelectorKey 2364
Your coding agent can read these notes before it upgrades. Set up the MCP server →
<Trans i18nKey={sk} /> to accept a SelectorKey 2364exists() is now a type guard that narrows the key to SelectorKey, so a validated key can be passed directly to t() 2364check also for I18NEXT_NO_SUPPORT_NOTICE env variable
feat(types): keyFromSelector is now type-safe — the selector callback is constrained against your resource definitions, catching invalid keys at compi
keyFromSelector is now type-safe — the selector callback is constrained against your resource definitions, catching invalid keys at compile time. Supports optional ns and keyPrefix options for non-default namespace/prefix contexts 2364fix(types): FilterKeys now correctly excludes base keys that have context variants when the provided context doesn't match any of them (e.g. key some
FilterKeys now correctly excludes base keys that have context variants when the provided context doesn't match any of them (e.g. key some with variant some_me is no longer accessible with context="one")feat(types): keyFromSelector now returns a branded SelectorKey type that t() accepts directly, enabling pre-computed and reusable translation keys 236
keyFromSelector now returns a branded SelectorKey type that t() accepts directly, enabling pre-computed and reusable translation keys 2364keyPrefix in getFixedT and per-call options 2367{{val, number}} requires number, {{val, datetime}} requires Date, {{name}} requires string, etc. Custom formatters can be typed via interpolationFormatTypeMap in CustomTypeOptions 2378FilterKeys in selector mode now preserves non-context, non-plural leaf keys when context is provided, fixing incorrect type narrowing when combining returnObjects: true with context 2398feat(types): selector API now enforces { count: number } when a key resolves to plural forms 2373
- fix: getFixedT() selector now resolves namespaces against the effective ns rather than the global init options #2406
getFixedT() selector now resolves namespaces against the effective ns rather than the global init options #2406fix: selector API namespace resolution regression for single-string ns and primary namespace in array #2405. Reverts the broad namespace-prefix rewrit
ns and primary namespace in array #2405. Reverts the broad namespace-prefix rewrite from v25.8.15 and replaces it with a targeted fix that only rewrites paths starting with a secondary namespace in a multi-namespace array, matching the type-level contract of GetSourceimprove selector api to accept array of selector functions, analogous to array of keys 2404
- update deps
fix(types): on() method now correctly returns this instead of void, matching the runtime behavior and enabling proper method chaining in TypeScript
on() method now correctly returns this instead of void, matching the runtime behavior and enabling proper method chaining in TypeScriptfix: Selector API unable to resolve namespaces #2402
fix: getCleanedCode now replaces all underscores
improve support notice shown logic
improve support notice shown logic
revert fix: compatibility with moduleResolution bundler (issue 2380) 2381
fix(interpolator): guard null matchedDoubleQuotes in nesting option parsing 2395
fix(interpolator): escape nestingOptionsSeparator in nesting option parsing 223943
types(i18n): add missing toJSON() declaration 2393
avoid crash due to ReferenceError without Intl API 2391
ts: address incomplete type definition for getFixedT() return value 2318
getFixedT() return value 2318fix: compatibility with moduleResolution bundler (issue 2380) 2381
fix: crashes when backend in backends array has no name property 2386
ts: document option to suppress the support message 2385
option to suppress the support message 2385
fix(types): Selector API - fix Namespace inference for selector ns option 2384
fix: TFunctionReturn fallback 2360
fix: Interpolation breaks when cloning an instance 2376
type definitions for new transDefaultProps option in react-i18next react-i18next: #1895
fix: Invalid overwrite of default value for overloadTranslationOptionHandler 2374.
TS: remove wrong signature 2372.
Enhance cloneInstance to create a new interpolator if interpolation options are passed in. This will address 2371.
cloneInstance to create a new interpolator if interpolation options are passed in. This will address 2371.- chore: dependency updates 2368
- types: export InterpolationMap
InterpolationMapfix: createInstance does not exist on an instance #2366
feat: exists() method now respects returnObjects option - returns false when accessing an object key with returnObjects: false, enabling detection of
feat: exists() method now respects returnObjects option - returns false when accessing an object key with returnObjects: false, enabling detection of object vs string keys 2359
Note: This is a potential behavior change. If you were previously calling exists() with returnObjects: false on object keys, those calls will now return false instead of true. This enables developers to detect whether a key points to an object or string value.
export esm type declaration for keyFromSelector 2356
fix last change => for cjs there is just 1 default export, no named exports, fixes 2348
export keyFromSelector from index.cjs 2347
export keyFromSelector function for testing purposes 2346
fix: enableSelector: true doesn't work with custom keySeparator 2341
fix: KeyPrefix not working with new selector api 2340
add new selector API to improve TypeScript IDE performance 2322
enableSelector: true in your configuration optionsenableSelector: "optimize", i18next can now handle translation dictionaries of any size, without affecting IDE performance or build timesimprove fix: Ordinals and non-ordinals don't work together 2337
fix: Ordinals and non-ordinals don't work together 2337
- remove unnecessary debug logs
fix: Brackets breaking nesting interpolation 2336
fix dir() for non-Intl language codes 2330
dir() for non-Intl language codes 2330warn if legacy interpolation.format function is still used
interpolation.format function is still usedfeat: support formatting function with plural and interpolation 2325
streamline fallbackLng option of t call with the init options 2312
fallbackLng option of t call with the init options 2312introduce cacheInBuiltFormats option to address 2227
cacheInBuiltFormats option to address 2227Ensure nsSeparator is respected when appendNamespaceToMissingKey is true 2311, fixes 2310
do not mutate t options, fixes 2307
fix options type for parseMissingKeyHandler
parseMissingKeyHandlerfeat: parseMissingKeyHandler now takes options as parameter like in missingKeyHandler 2304
parseMissingKeyHandler now takes options as parameter like in missingKeyHandler 2304fix cloneInstance with forkResourceStore: true addresses 2303
cloneInstance with forkResourceStore: true addresses 2303optimize changeLanguage to correctly use getBestMatchFromCodes (string or array) 2299 and improve resolvedLanguage set for non canonical codes
changeLanguage to correctly use getBestMatchFromCodes (string or array) 2299 and improve resolvedLanguage set for non canonical codesOne column per quarter.