Carregando recursos ...
site multilingue com reactreact-i18nexti18nexthreflangseo multilingueinternacionalizacao react

Site Multilíngue com React: Guia com i18next e SEO

SCStormcore
6 min de leitura

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:

  1. Instale os pacotes: npm install i18next react-i18next i18next-browser-languagedetector
  2. Crie uma pasta locales com um arquivo translation.json para cada idioma.
  3. Inicialize o i18next em um arquivo i18n.js e importe-o no main.jsx.
  4. Use o hook useTranslation nos componentes.

Um exemplo de inicialização:

code
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:

code
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:

code
<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 href deve ser a URL canônica de cada versão.
  • Use x-default para 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.

Continue lendo

Matérias relacionadas

Pronto para tirar sua ideia do papel?

Fale agora com nosso time de desenvolvimento. Sites, apps, automações, o que você precisar.

Chamar no WhatsApp

Resposta em até 2 horas