Site Multilíngue com React: Guia com i18next e SEO
Site Multilíngue com React: Guia com i18next e SEO
Para criar um site multilíngue com React, instale o i18next e o react-i18next, separe as traduções em arquivos JSON por idioma e use o hook useTranslation nos componentes. Para o Google entender cada versão, use uma URL própria por idioma (como /en/ e /es/) e declare as relações entre elas com a tag hreflang. Traduzir os textos resolve só metade do problema: a outra metade é SEO.
Por que criar um site multilíngue
Um site em mais de um idioma permite atender clientes de outros países, captar buscas em inglês ou espanhol e transmitir profissionalismo para negócios que exportam ou atendem estrangeiros. Para uma agência ou empresa de serviços, é uma forma de abrir mercado sem criar um segundo site do zero.
O ponto de atenção é que um site multilíngue não é só uma troca de textos. Ele exige decisões de estrutura de URL, detecção de idioma e marcação para os buscadores. Quem ignora isso costuma ver o Google mostrando a versão errada nos resultados.
Qual biblioteca usar para internacionalização em React
Para projetos com Vite e React, o react-i18next é a escolha mais comum. Segundo o comparativo do PkgPulse para 2026, ele soma cerca de 8 milhões de downloads semanais e funciona em qualquer configuração de React, incluindo Vite. O i18next, base dele, existe desde 2011.
As principais alternativas são:
- react-intl (FormatJS): usa o formato ICU e formatação de datas e números baseada em CLDR, muito usado em projetos corporativos.
- LinguiJS: compila as mensagens em tempo de build, o que reduz o tamanho final do pacote.
- next-intl: a opção mais completa quando o projeto é Next.js com App Router.
Existe um custo: um comparativo publicado pela Intlayer indica que o react-i18next tem cerca de 17 KB gzipped. Para landing pages que precisam de nota alta em desempenho, vale medir o impacto antes de decidir.
Como configurar o react-i18next no Vite
A configuração básica tem quatro passos:
- Instale os pacotes:
npm install i18next react-i18next i18next-browser-languagedetector - Crie uma pasta
localescom um arquivotranslation.jsonpara cada idioma. - Inicialize o i18next em um arquivo
i18n.jse importe-o nomain.jsx. - Use o hook
useTranslationnos componentes.
Um exemplo de inicialização:
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
import LanguageDetector from 'i18next-browser-languagedetector';
import pt from './locales/pt/translation.json';
import en from './locales/en/translation.json';
i18n
.use(LanguageDetector)
.use(initReactI18next)
.init({
resources: { pt: { translation: pt }, en: { translation: en } },
fallbackLng: 'pt',
interpolation: { escapeValue: false },
});
export default i18n;
E o uso em um componente:
import { useTranslation } from 'react-i18next';
function Hero() {
const { t } = useTranslation();
return <h1>{t('hero.title')}</h1>;
}
O escapeValue: false é seguro aqui porque o React já protege contra XSS. Para frases com links ou negrito no meio do texto, use o componente Trans.
Organize as chaves de tradução
Use nomes hierárquicos como hero.title e footer.contact, em vez de usar a frase inteira como chave. Isso evita quebrar traduções quando o texto em português muda e facilita encontrar chaves ausentes.
Estrutura de URL para SEO multilíngue
Antes de pensar em código, escolha como as versões vão aparecer na URL. A documentação do Google sobre sites multilíngues orienta usar URLs diferentes para cada idioma, em vez de trocar o conteúdo na mesma URL. As três estratégias mais comuns são:
- Subdiretórios:
seusite.com.br/en/ - Subdomínios:
en.seusite.com.br - Domínios por país:
seusite.com
Para a maioria dos projetos, os subdiretórios oferecem o melhor equilíbrio entre SEO, dificuldade de implementação e manutenção, pois toda a autoridade do domínio fica concentrada em um lugar só. No React, isso se resolve com o React Router, usando um parâmetro de idioma na rota, como /:lang/sobre.
Como configurar hreflang
O hreflang é o atributo que informa ao Google qual versão de uma página serve para cada idioma ou região. Ele foi introduzido pelo Google em dezembro de 2011 e ajuda a evitar que versões traduzidas sejam tratadas como conteúdo duplicado.
Cada página deve listar todas as suas versões, incluindo ela mesma:
<link rel="alternate" hreflang="pt-BR" href="https://seusite.com.br/pt/" />
<link rel="alternate" hreflang="en" href="https://seusite.com.br/en/" />
<link rel="alternate" hreflang="x-default" href="https://seusite.com.br/" />
Boas práticas importantes:
- As marcações precisam ser recíprocas: se a página A aponta para B, a B deve apontar para A.
- O valor de
hrefdeve ser a URL canônica de cada versão. - Use
x-defaultpara a versão que atende usuários sem idioma correspondente. - Também é possível declarar o hreflang no sitemap, o que facilita sites com muitas páginas.
Um alerta específico para Vite: como o React renderiza no navegador, as tags precisam estar no HTML que o buscador recebe. Para sites que dependem de SEO, considere pré-renderização ou geração estática das páginas de cada idioma, e atualize <html lang> e o título conforme o idioma ativo.
Perguntas Frequentes
Qual a melhor biblioteca para site multilíngue com React? Para projetos com Vite, o react-i18next é a opção mais usada e funciona em qualquer configuração de React. Para Next.js com App Router, o next-intl costuma ser a escolha mais completa.
O Google penaliza conteúdo traduzido como duplicado? Páginas traduzidas legítimas, com URLs próprias e hreflang correto, são tratadas como versões alternativas. O problema surge quando as versões ficam sem marcação e o Google não consegue relacioná-las.
É melhor usar subdiretório, subdomínio ou domínio por país? Na maioria dos casos, subdiretórios são mais simples e concentram a autoridade em um único domínio. Domínios por país fazem sentido só quando há operação separada em cada mercado.
Preciso traduzir o site inteiro de uma vez? Não. Você pode começar pelas páginas principais, como a home e os serviços. Cada página traduzida precisa apontar para as suas versões por hreflang, e páginas sem tradução não devem receber a marcação.
Trocar o idioma só com um botão e estado do React funciona para SEO? Não é suficiente. Se a URL não muda, o Google não consegue indexar cada idioma separadamente. É preciso uma URL própria para cada versão.
Conclusão
Um site multilíngue com React funciona bem quando três pilares andam juntos: uma biblioteca de tradução como o react-i18next, uma estrutura de URLs clara por idioma e a marcação hreflang correta. Comece com poucas páginas, valide a indexação no Google Search Console e expanda aos poucos. Na Stormcore, desenvolvemos sites e sistemas em React preparados para SEO e para mais de um idioma, quando o negócio pede expansão.
Matérias relacionadas
ERP para Pequenas Empresas: Como Escolher o Sistema Ideal
IA para Resumir Documentos: Como Usar na Sua Empresa
Bio do Instagram para Empresas: Como Fazer e Converter
Formulário de Contato com React e Supabase (Guia)
Gateway de Pagamento para Site: Como Escolher o Ideal
IA para criar logotipo: guia, ferramentas e riscos
Pronto para tirar sua ideia do papel?
Fale agora com nosso time de desenvolvimento. Sites, apps, automações, o que você precisar.
Chamar no WhatsAppResposta em até 2 horas