SSR (additional components)

i18next localization as a service Find your translator

Search…

Using Next.js?
You should have a look at next-i18next which extends react-i18next to bring it to next.js the easiest way.
With [email protected] and Next.js v10, next-i18next has done a major rewrite of the package, leveraging the built-in internationalized routing provided by Next.js.
​Here you can also find a next-i18next app example in combination with locize, that offers 2 different approaches.
[email protected] supports Next.js v9.5 in Serverless mode (as of July 2020). If your goal is to use earlier versions of Next.js with Serverless, then you should have a look at "Next Right Now", which is a Next.js 9 boilerplate with built-in i18next, react-i18next and Locize.
Looking for an optimized Next.js translations setup?
Here you'll find a blog post on how to best use next-i18next with client side translation download and SEO optimization.
​​
​​
​
Using SSG / next export?
Here you'll find a simple tutorial on how to best use next-i18next in a SSG environment.
​
​​
Using Remix?
You should have a look at remix-i18next which extends react-i18next to bring it to Remix the easiest way.
​Here you'll find a simple example and here a step by step tutorial on how to best use remix-i18next.
​​
​​
Using Gatsby?
You should have a look at gatsby-plugin-react-i18next which extends react-i18next to bring it to Gatsby the easiest way.
​Here you'll find a simple example and here a step by step tutorial on how to best use gatsby-plugin-react-i18next.
​​
​​
Setting the i18next instance based on req
Use the I18nextProvider to inject the i18next instance for example bound to the http i18n instance on the request object using i18next-http-middleware.
<I18nextProvider i18n={req.i18n}>
  <App />
</I18nextProvider>
Passing initial translations / initial language down to client
To avoid asynchronous loading of translation on the client side (and the possible Suspense out of that) you will need to pass down initialLanguage (will call changeLanguage on i18next) and initialI18nStore (will prefill translations in i18next store).
using the useSSR hook
import React from 'react';
import { useSSR } from 'react-i18next';
​
export function InitSSR({ initialI18nStore, initialLanguage }) {
  useSSR(initialI18nStore, initialLanguage);
​
  return <App />
}
using the withSSR HOC
import React from 'react';
import { withSSR } from 'react-i18next';
import App from './App';
​
const ExtendedApp = withSSR()(App);
​
<ExtendedApp initialLanguage={} initialI18nStore={} />
The ExtendedApp in this case will also have the composed ExtendedApp.getInitialProps()

Last modified 6d ago

Copy link

Outline

Using Next.js?

Using Remix?

Using Gatsby?

Setting the i18next instance based on req

Passing initial translations / initial language down to client

using the useSSR hook

using the withSSR HOC