Migrate from next-i18next to Intlayer

For a complete and detailed step-by-step tutorial, please see our full next-i18next Migration Guide.

Intlayer handles all Next.js Pages Router and App Router implementations transparently. Using the adapter lets you migrate your next-i18next implementation with zero code rewrite.

What to do

To begin, run:

npx intlayer init

This creates the required Intlayer setup file. To swap to Intlayer behind the scenes, update your next.config.ts:

import type { NextConfig } from "next";import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";const withIntlayer = createNextI18nPlugin();const nextConfig: NextConfig = {};export default withIntlayer(nextConfig);

What it does under the hood

The createNextI18nPlugin composes Next.js's native behavior alongside the core next-intlayer plugin, injecting all required Webpack/Turbopack aliases for next-i18next, react-i18next, and i18next.

Under the hood:

• serverSideTranslations & appWithTranslation: They now function as wrappers for Intlayer's internal loaders, circumventing large static JSON injection.
• Client hooks: Delegates immediately to @intlayer/react-i18next retaining all formatting, plurals, and nested namespace features.