A tag hreflang informa ao Google qual versão de idioma servir a cada visitante de um site multilíngue. Segundo o Google Search Central (2024), se duas páginas não apontam uma para a outra, as anotações são ignoradas. O return-link recíproco é o erro número um. Configure por plugin, sitemap ou cabeçalho HTTP.
A tag hreflang é um atributo HTML que diz aos buscadores qual variação de idioma ou região de uma página exibir para cada usuário. Em um site WordPress multilíngue, ela evita que um leitor do Brasil caia na versão em inglês e que o Google trate suas traduções como conteúdo duplicado. A configuração não é difícil, mas é cheia de detalhes que quebram em silêncio: um código de região errado ou um return-link faltando já basta para o Google descartar tudo. Este tutorial mostra os 3 métodos oficiais, o papel do x-default e como validar antes de publicar. Para o panorama do tema, veja o hub de WordPress multilíngue da FULL.
Hreflang em 1 minuto: O que é e quando usar
A tag hreflang resolve 1 problema específico: dizer ao Google que a versão em português e a versão em inglês da mesma página são traduções, não cópias concorrentes. Segundo o Google Search Central (2024), os 3 métodos de implementação são equivalentes para o buscador.
A escolha entre os 3 caminhos depende do seu volume de idiomas e de quem mantém o site no dia a dia. A tabela abaixo resume cada método antes de você decidir qual usar.
| Método | Onde a tag vive | Melhor cenário |
|---|---|---|
| Link tags no <head> | HTML de cada página | Até 5 idiomas, gerado por plugin |
| XML Sitemap | Arquivo sitemap.xml | Catálogo grande, 6+ idiomas |
| Cabeçalho HTTP | Resposta do servidor | Arquivos não-HTML, como PDF |
No suporte da FULL, a gente vê que a maioria dos sites WordPress usa link tags geradas por plugin, porque é o caminho que não exige tocar no servidor.
Hreflang ou canonical: Por que confundir os dois quebra o SEO
Confundir hreflang com a tag canonical é o erro conceitual que mais aparece nos tickets da FULL: são 2 sinais distintos. A hreflang declara equivalência entre idiomas; a tag canonical declara qual URL é a versão preferida quando há duplicatas de conteúdo.
Em , sites que apontam o canonical de todas as traduções para a versão em inglês acabam desindexando as versões em português, porque dizem ao Google que elas não devem rankear. A regra prática é direta: cada versão de idioma tem seu próprio canonical apontando para si mesma, e todas as versões usam hreflang para se referenciarem entre si. Misturar os dois sinais é como pedir indexação e negá-la na mesma página, e o Google tende a obedecer ao sinal mais restritivo. Para a base técnica, consulte o conceito de SEO internacional antes de escalar idiomas no projeto.
Passo a passo: Configurar hreflang em site multilíngue
Configurar hreflang em um site multilíngue leva 5 passos, do plugin de tradução à validação final no Google Search Console, em menos de 30 minutos num site com 2 ou 3 idiomas usando WPML ou Polylang.
Os passos abaixo assumem que você já tem o conteúdo traduzido publicado; a tag hreflang conecta versões que já existem, ela não traduz nada por conta própria.
Passo 1: Escolha o plugin de tradução
Escolha o plugin que gera as tags hreflang automaticamente, porque inserir à mão em dezenas de páginas é insustentável. WPML, Polylang e TranslatePress cobrem o WordPress multilíngue e emitem as anotações sem código. WPML domina e-commerce e traduções gerenciadas; Polylang compete por leveza e por uma versão gratuita funcional; TranslatePress aposta na tradução visual direto no front-end. Para começar do zero, o guia de como criar um site WordPress multilíngue cobre a instalação de ponta a ponta. [IMAGEM: painel de idiomas | alt=”hreflang configurado no painel de idiomas do WordPress”]
Legenda: o painel de idiomas do plugin é onde o mapeamento entre versões nasce, e é dele que a tag hreflang é derivada.
Passo 2: Defina os códigos de idioma e região
Defina os códigos no formato que o Google exige: idioma em ISO 639-1, com região opcional em ISO 3166-1 Alpha 2. Segundo o Google, o primeiro código é o idioma (pt, en, es) e o segundo, opcional, é a região (pt-BR, en-US). A regra que pega a maioria: você não pode especificar só o país. Escrever hreflang="BR" é inválido e a anotação é descartada; o correto é pt-BR ou apenas pt. Use região só quando o conteúdo difere de fato entre países do mesmo idioma, como pt-BR e pt-PT.
Passo 3: Adicione o valor x-default
Adicione o x-default para cobrir os visitantes cujo idioma não está mapeado no seu site. O valor reservado x-default é servido quando nenhuma outra combinação de idioma ou região bate com a configuração do navegador do usuário, segundo a documentação do Google. Na prática, ele aponta para a sua página de seleção de idioma ou para a versão padrão, em geral a página inicial. Sem x-default, um visitante de um idioma que você não publicou fica sem fallback definido, e o Google escolhe sozinho qual versão exibir, o que costuma ser a errada.
Passo 4: Garanta o return-link recíproco
Garanta que toda página referenciada aponte de volta, porque sem isso o Google ignora as tags. A regra é literal na documentação: se duas páginas não apontam uma para a outra, as anotações hreflang são descartadas. A versão em português precisa listar a versão em inglês, e a versão em inglês precisa listar a versão em português, ambas incluindo um auto-referência. Plugins como WPML geram esse mapa recíproco automaticamente, mas implementações manuais ou híbridas quebram justamente aqui. É o ponto onde a maioria dos casos de hreflang que não funciona realmente trava.
Passo 5: Valide no Google Search Console
Valide a implementação no relatório de indexação do Google Search Console depois de publicar. O Search Console mostra erros de hreflang como anotações sem return-link ou códigos inválidos, e é a fonte da verdade sobre o que o Googlebot realmente leu. A leitura pode levar dias após o rastreamento, então não espere feedback imediato. Para um diagnóstico mais amplo, cruze com o checklist de SEO técnico do site inteiro.
Os 4 erros de hreflang que fazem o Google ignorar tudo
Quatro erros respondem pela maioria dos casos de hreflang que não funciona em um site multilíngue, e os 4 passam despercebidos porque não geram nenhuma mensagem visível no painel do WordPress nem na página renderizada para o visitante final.
O primeiro é o return-link faltando, que sozinho invalida o par inteiro de páginas. O segundo é o código de região isolado, como hreflang="BR" sem idioma, descartado por formato inválido. O terceiro é o conflito entre hreflang e canonical apontando para idiomas diferentes, que cancela o sinal de equivalência. O quarto é o x-default ausente em sites com público internacional amplo. A gente vê no suporte da FULL que boa parte dos chamados de “tradução não aparece no Google” cai em um desses 4 erros silenciosos. O guia de erros comuns em sites multilíngues detalha os sintomas de cada um deles.
Hreflang com cache e CDN: O conflito silencioso
hreflang e cache de página convivem bem na maioria dos sites, mas 1 configuração específica faz o servidor entregar a versão errada das tags. O conflito é silencioso: não há erro no painel, só a tradução aparecendo com o bloco hreflang de outro idioma.
WP Rocket, ou qualquer cache que armazene uma única cópia do HTML por URL, somado a um plugin que injeta hreflang via PHP na renderização, em servidores sem variação por idioma, pode fazer todas as línguas receberem as tags da primeira versão cacheada. A correção tende a ser excluir as URLs de troca de idioma do cache ou usar o sitemap como fonte. O artigo sobre WP Rocket com WPML mostra as exclusões corretas. Em sites com mais de 6 idiomas no WPML, gerar hreflang via XML sitemap em vez de link tags no head reduz o peso de HTML por página.
Ative o stack multilíngue completo no bundle da FULL
Montar um site multilíngue sólido exige mais que a tag hreflang: você precisa do plugin de tradução, do cache configurado por idioma e de um plugin de SEO que respeite o mapeamento de versões sem quebrar o return-link recíproco.
No plano PRO da FULL, por R$849, você ativa o bundle com WP Rocket, Rank Math PRO e os demais plugins premium já licenciados, o que dá R$85 por site quando você gerencia os 10 sites do plano. A gente vê no suporte que comprar cada licença avulsa para um projeto multilíngue passa fácil de mil reais por ano, enquanto o bundle dilui esse custo entre todos os sites. Conheça os planos da FULL e ative tudo em um clique. Para um alternador de idioma no front-end, o tutorial de como adicionar um alternador de idioma fecha a experiência do usuário.
Perguntas frequentes sobre hreflang
Por que o Google ignora minhas tags hreflang mesmo bem escritas?
Quase sempre porque falta o return-link recíproco. A documentação do Google é literal: se duas páginas não apontam uma para a outra, as anotações são descartadas. Uma tag hreflang sintaticamente perfeita na versão em português é ignorada se a versão em inglês não referenciar a portuguesa de volta. Verifique no Google Search Console se o relatório acusa “sem tag de retorno” antes de suspeitar do código em si.
É possível configurar hreflang sem plugin no WordPress?
Sim, é possível, mas raramente vale a pena. Você pode inserir as link tags no <head> via functions.php ou declarar as anotações no XML sitemap manualmente. O problema é manter o return-link recíproco e o x-default em cada página nova, o que vira insustentável a partir de 2 idiomas. Plugins como WPML e Polylang automatizam exatamente esse mapeamento, por isso a grande maioria dos sites usa um deles.
Qual a diferença entre hreflang e a tag canonical?
hreflang declara que duas URLs são traduções equivalentes; canonical declara qual URL é a versão preferida entre duplicatas. São sinais diferentes e não se substituem. Cada versão de idioma deve ter canonical apontando para si mesma e usar hreflang para listar as outras línguas. Apontar o canonical de uma tradução para outro idioma desindexa essa tradução, porque diz ao Google para não rankear aquela URL.
Quantos idiomas o hreflang suporta em um único site?
Não há limite técnico de idiomas no hreflang; sites com mais de 20 versões funcionam normalmente. O que muda com a escala é o método: acima de 6 idiomas, gerar as anotações via XML sitemap em vez de link tags no <head> evita que o HTML de cada página cresça centenas de linhas. Os 3 métodos são equivalentes para o Google, então a escolha é de manutenção, não de capacidade.
O que é o valor x-default no hreflang?
O x-default é um valor reservado de hreflang servido quando nenhum idioma ou região do site bate com a configuração do navegador do visitante. Na prática, ele aponta para a página de seleção de idioma ou para a versão padrão, normalmente a home. Sem x-default, um usuário de um idioma não publicado fica sem fallback definido e o Google escolhe sozinho qual versão exibir, em geral a menos relevante para aquele leitor.
Próximos passos para o seu site multilíngue
Com hreflang configurado, return-link recíproco garantido e x-default no lugar, o seu site multilíngue passa a dizer ao Google exatamente qual versão servir a cada visitante. O ponto crítico não é escrever a tag, é manter o mapeamento recíproco íntegro a cada novo idioma ou página, e validar no Google Search Console em vez de assumir que funcionou. Antes de escalar, revise a relação entre hreflang e sitemap XML e o impacto no SEO técnico do site. Para continuar aprendendo, o guia de SEO para WordPress da FULL reúne os tutoriais de internacionalização e indexação em um só lugar.
















