NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2832 most downloaded on npm
Internationalization for react done right. Using the i18next i18n ecosystem.
Last release 13 days ago
21 Sep 2026
Release timing varies
gaps range from 8 days to 2 months
Most releases are documented
notes for 44 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
388 releases · first in 2015
removes componentWillMount lifecycle method from I18n.js render props as it will get deprecated on react 16.3 404
Fix reference to props in constructor PR411
One column per quarter.
passes down tReady from translate hoc for cases you prefer showing a placeholder instead of default return null in case of wait: true and not yet load
enables setting prop ns on Trans component to override namespace passed by render prop or hoc
ns on Trans component to override namespace passed by render prop or hocreorder selection of i18n in I18n render prop
reorder selection of i18n in I18n render prop
more save access to options in general
more save access to options.react
replace Interpolate PureComponent with Component to assert it gets rerendered on lng change
remove react-dom from peer dependencies as module is used in react-native too
Allow translate HOC to take a function for getting namespaces 372
Add usePureComponent option PR357
fixes: bring back Trans component t fc from context
optional take i18n.t in Trans component if non t function passed in via props or context
fixes rendering in Trans component in case of no parent
working Trans component without the need of setting options.react
[BREAKING] As with react 16 you can return multiple elements from render - based on that we do not need to return a wrapper any longer from Trans comp
Starting with v7.0.0 Trans component per default won't add a parent div around content passed as children. It will just return it's children.
You still got the option to set a parent if you prefer content being wrapped.
If you prefer wrapping for all your Trans components (or for backwards compatibility) you can set option react.defaultTransParent to an element on i18next init.
adds hashTransKey function for custom key generation in case of not passing a key to Trans component and not like having the source value as key
pre-check namespaces to avoid unnecessary initial null render PR336
null render PR336remove PureComponent from Trans
fixes support passing i18n and t to Trans as props PR315
- fixes translate hoc build
stop using PureComponent and use Component again...seems we get an issue with react-router v4 if using PureComponents
rebuild needed cause of uppercasing for components name was not reflected in last build
remove react from dependencies - not sure how that came into the package.json
[BREAKING] removes options to set translateFuncName in translate hoc (was not supported in Trans and Interpolate component anyway)
fixes AST implementation for preact
replaces regex used to parse nodes from string to an ast implementation solving #298
Pass extra parameters to Trans parent component
adds module export in package.json pointing to es dist files.
you now can set i18n instance on translate hoc once using setI18n:
import translate from 'react-i18next';
import i18n from './i18n';
translate.setI18n(i18n);
[BREAKING] we no longer accept wait to be specified on i18next init options like { wait: true } -> all overrides for the translate hoc now have to be
{ wait: true } -> all overrides for the translate hoc now have to be in child react like { react: { wait: true } }translateFuncName as we need that upfront to define childContextTypes)i18next.init({
// ... other options
react: {
wait: false,
withRef: false,
bindI18n: 'languageChanged loaded',
bindStore: 'added removed',
nsMode: 'default'
}
});
translateFuncName) by using:import translate from 'react-i18next';
translate.setDefaults({
wait: false,
withRef: false,
bindI18n: 'languageChanged loaded',
bindStore: 'added removed',
nsMode: 'default',
translateFuncName: 't'
});
make trans component work with preact and preact-compat
Trans component parent element configurable PR278
optimize generated defaultValue for components not having children
move react, prop-types, ... to peerDependency again
optimize trans component output
fixes issue in changeLanguage on set via translate hoc ssr
allow passing initialI18nStore and initialLanguage to I18nextProvider via props to support simpler ssr
pass i18n instance to context inside translate hoc to simplify usage in nextjs
introduces Trans component which enables you to translate nested components incl. interpolation by resulting in one translatable string. learn more
allow passing down initialI18nStore and initialLanguage to translate hoc to support ssr scenario better see example/nextjs
allow passing i18next instance in translate hoc options makes integration in nextjs easier
Remove workaround to set ready if there was no initialized signal PR263
Fix react-i18next to work with TypeScript PR261
flag nsMode: 'fallback' -> uses namespaces passed to translate hoc as fallbacks #254
deploys 3.1.1 as possible breaking: fixes issue in fixing t function - pass only first namespace not an array of namespaces (access other namespaces l
- reverts last change
fixes issue in fixing t function - pass only first namespace not an array of namespaces
fixes wrong warning of missing prop on interpolate with format
i18next.init({ wait: true })[BREAKING] assert you install prop-types as a peerDependency based on changes in react >= 15.5.x
try not access store if undefined for hmr
Nothing published for this version
fixes validation for missing prop in interpolate component
support formatting inside interpolate component
tanslate hoc: expose the i18n instance via props
Nothing published for this version
translate hoc wait option asserts now that i18next is initialized before rendering (waits for lng detection)
pass style prop to interpolate component
Suppresses required context type warning if passing i18n as a prop PR205
Your coding agent can read these notes before it upgrades. Set up the MCP server →