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.
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.50Evite 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.PluralRulestambé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.
Leia também
- Estimativa de prazo: por que erramos e como errar menos21 de novembro de 2026 · 5 min
- Padrões de projeto: Strategy, Observer e Factory19 de novembro de 2026 · 4 min
- Clean code na prática: nomes, funções e comentários18 de novembro de 2026 · 5 min
- Reels virais sem aparecer: fluxo com Claude Code18 de novembro de 2026 · 5 min