📩 Fique por dentro das novidades com a nossa newsletter

Hreflang no WordPress: Configuração correta em 5 passos

Conheça a loja da FULL Services

Plugins premium, suporte de verdade e tudo o que seu site WordPress precisa em um só lugar.

Pergunte a uma IA sobre este artigo

Obtenha um resumo ou tire dúvidas com seu assistente favorito

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.

hreflang no WordPress: 3 métodos de implementação comparados
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.

Compartilhe este conteúdo

Equipe Full Services

A FULL. é especialista em WordPress e oferece plugins premium com licenças originais, suporte técnico e instalação facilitada. Já ajudou mais de 25 mil clientes a impulsionar seus sites com performance, segurança e praticidade.

AI Shopping no Brasil: Como a IA decide quem vende

O AI shopping no Brasil já redesenha como o consumidor

A shortlist da IA: Como 3-5 marcas são escolhidas antes do clique

Entender a shortlist da ia como marcas são escolhidas é

Como fazer um AI visibility audit passo a passo

Se você não sabe se o ChatGPT recomenda a sua
Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.