i18n no Next.js: site em vários idiomas sem dor

Como estruturar um site multilíngue no Next.js, rotas por idioma, dicionários de tradução, detecção de idioma no middleware, formatação de datas e números, e os cuidados de SEO com hreflang.

tecnico nextjs frontend 5 min de leitura

Colocar um site em mais de um idioma parece uma tarefa de tradução, mas é principalmente uma tarefa de arquitetura. Se a estrutura certa não estiver pronta desde o início, adicionar um segundo idioma depois obriga a revisar quase todas as telas. Vale conhecer as peças antes de começar.

i18n e l10n

Internacionalização (i18n, porque tem 18 letras entre o "i" e o "n") é preparar o código pra suportar vários idiomas e regiões. Localização (l10n) é de fato adaptar o conteúdo pra cada um. Você faz a primeira uma vez e a segunda a cada idioma novo.

1. Rotas por idioma

A abordagem mais comum e melhor pra SEO é colocar o idioma na URL:

/pt/blog/meu-post
/en/blog/meu-post

No App Router do Next.js, isso vira um segmento dinâmico na raiz de app:

app/
  [lang]/
    layout.tsx
    page.tsx
    blog/
      [slug]/
        page.tsx

Cada idioma tem a própria URL, o que permite compartilhar um link no idioma certo e deixa os buscadores indexarem cada versão separadamente. Alternativas como subdomínio (en.site.com) ou domínio por país funcionam, mas exigem mais infraestrutura.

2. Dicionários de tradução

Os textos saem do código e vão pra arquivos por idioma:

// dictionaries/pt.json
{
  "home": {
    "titulo": "Bem-vindo",
    "botao": "Começar agora"
  }
}
// dictionaries/en.json
{
  "home": {
    "titulo": "Welcome",
    "botao": "Get started"
  }
}

Um carregador escolhe o arquivo certo, aproveitando que Server Components podem importar dinamicamente sem enviar o dicionário inteiro pro navegador:

// lib/dictionaries.ts
const dictionaries = {
  pt: () => import("@/dictionaries/pt.json").then((m) => m.default),
  en: () => import("@/dictionaries/en.json").then((m) => m.default),
};
 
export const getDictionary = (lang: "pt" | "en") => dictionaries[lang]();
// app/[lang]/page.tsx
export default async function Home({
  params,
}: {
  params: Promise<{ lang: "pt" | "en" }>;
}) {
  const { lang } = await params;
  const t = await getDictionary(lang);
 
  return (
    <main>
      <h1>{t.home.titulo}</h1>
      <button>{t.home.botao}</button>
    </main>
  );
}

Com TypeScript, dá pra tipar o dicionário e garantir que todos os idiomas tenham as mesmas chaves, evitando o texto faltando só em produção.

Em projetos maiores, bibliotecas como next-intl resolvem isso com mais recursos: plurais, interpolação de variáveis e tradução também em Client Components.

3. Detectar e redirecionar o idioma

Quando o usuário acessa / sem idioma, você decide pra onde mandar. Um middleware lê o cabeçalho Accept-Language do navegador e redireciona:

// middleware.ts
import { NextRequest, NextResponse } from "next/server";
 
const idiomas = ["pt", "en"];
const padrao = "pt";
 
function detectarIdioma(request: NextRequest) {
  const cabecalho = request.headers.get("accept-language") ?? "";
  const preferido = cabecalho.split(",")[0]?.split("-")[0];
  return idiomas.includes(preferido) ? preferido : padrao;
}
 
export function middleware(request: NextRequest) {
  const { pathname } = request.nextUrl;
  const temIdioma = idiomas.some(
    (l) => pathname === `/${l}` || pathname.startsWith(`/${l}/`)
  );
 
  if (temIdioma) return;
 
  request.nextUrl.pathname = `/${detectarIdioma(request)}${pathname}`;
  return NextResponse.redirect(request.nextUrl);
}
 
export const config = {
  matcher: ["/((?!api|_next|.*\\..*).*)"],
};

Respeite uma escolha manual: se o usuário trocou de idioma no seletor, salve num cookie e dê prioridade a ele sobre o cabeçalho do navegador.

4. Datas, números e moedas

Traduzir texto não basta. Formatos mudam por região, e o JavaScript já traz isso pronto na API Intl:

const data = new Date("2026-11-20");
 
new Intl.DateTimeFormat("pt-BR").format(data); // 20/11/2026
new Intl.DateTimeFormat("en-US").format(data); // 11/20/2026
 
new Intl.NumberFormat("pt-BR", {
  style: "currency",
  currency: "BRL",
}).format(1234.5); // R$ 1.234,50
 
new Intl.NumberFormat("en-US", {
  style: "currency",
  currency: "USD",
}).format(1234.5); // $1,234.50

Evite montar datas e valores na mão. 11/10 é 11 de outubro no Brasil e 10 de novembro nos Estados Unidos, uma ambiguidade que já causou muito bug.

5. SEO multilíngue

Os buscadores precisam saber que as páginas são versões do mesmo conteúdo. Isso se faz com hreflang, e no Next.js sai pela API de metadata:

export async function generateMetadata({ params }) {
  const { lang, slug } = await params;
 
  return {
    alternates: {
      canonical: `https://meusite.com/${lang}/blog/${slug}`,
      languages: {
        pt: `https://meusite.com/pt/blog/${slug}`,
        en: `https://meusite.com/en/blog/${slug}`,
      },
    },
  };
}

Também mantenha <html lang={lang}> correto no layout, porque isso ajuda leitores de tela e buscadores, como falei no post sobre acessibilidade, e inclua todas as versões no sitemap.

Armadilhas comuns

  • Textos concatenados. Montar frases juntando pedaços ("Você tem " + n + " itens") quebra em idiomas com ordem de palavras diferente. Use mensagens completas com variáveis.
  • Plural. Em português e inglês há dois formatos, mas outros idiomas têm mais. Bibliotecas de i18n tratam isso, e Intl.PluralRules também.
  • Texto que cresce. Alemão costuma ser bem maior que inglês, e botões com largura fixa quebram.
  • Imagens com texto dentro. Cada idioma pede uma imagem nova.
  • Traduzir tarde demais. Textos espalhados no JSX, com cadeias soltas, viram um trabalho enorme de extração depois.

Fechando

Um site multilíngue bem feito depende de quatro decisões tomadas cedo: idioma na rota, textos num dicionário, formatação via Intl e metadados corretos pra SEO. Mesmo que você comece só com um idioma, estruturar assim desde o início transforma o segundo idioma em uma tarefa de tradução, não em uma reforma.

Direto na sua
caixa de entrada.

Um aviso por e-mail sempre que eu publicar um post novo. Sem spam, sem newsletter chata, só isso.