Tradução de sites

Como configurar corretamente o hreflang no WordPress (e os erros que podem prejudicar o funcionamento)

Como configurar corretamente o hreflang no WordPress (e os erros que podem prejudicar o funcionamento)
Rayne Aguilar
Escrito por
Rayne Aguilar
Elizabeth Pokorny
Revisado por
Elizabeth Pokorny
Atualizado em
5 de junho de 2026

Resposta curta: para configurar corretamente o hreflang no WordPress, cada versão de idioma de uma página precisa de um conjunto completo de tags hreflang que:

  1. apontar para si mesmos,
  2. apontar para todas as versões alternativas
  3. apontam um para o outro, e
  4. incluir um x-padrão alternativa, todas utilizando códigos de idioma válidos e URLs absolutas.

Se você errar em qualquer um desses itens, os mecanismos de busca ignoram todo o conjunto. Embora isso torne o processo bastante complicado, a maneira mais simples de fazer isso é usando um plugin que gere as tags automaticamente. Ainda assim, vale a pena conhecer as regras para que você mesmo possa verificar o resultado.

Vamos deixar uma coisa bem clara: adicionar tags hreflang e adicioná-las corretamente são duas coisas diferentes. O WordPress não adiciona tags hreflang por conta própria, então a maioria das pessoas recorre a um plugin ou a um snippet, vê as tags aparecerem no código-fonte da página e presume que está tudo resolvido. O que, se você tiver usado um plugin bem desenvolvido, deve funcionar.

Mas se você perceber que, de repente, o tráfego proveniente de uma versão traduzida começa a estagnar e o idioma errado aparece nos resultados de pesquisa, esses são bons sinais de que você deve verificar novamente sua implementação do hreflang.

Normalmente, as tags estão lá; só que é bem provável que estejam com algum erro de uma das muitas formas previsíveis — mas não é nada que você não consiga resolver sozinho.

Este guia aborda o que realmente significa “correto”, os erros que a maioria das pessoas comete e como verificar sua configuração. Se você deseja um passo a passo completo de todos os métodos para adicionar hreflang ao WordPress (plug-ins, ferramentas de SEO e código manual), nosso guia completo sobre hreflang no WordPress aborda esse assunto em profundidade.

O que "Hreflang correto" realmente significa

Hreflang é um atributo HTML que indica aos mecanismos de busca em que idioma e, opcionalmente, para qual região uma página se destina, para que eles possam apresentar a versão correta à pessoa certa (en-US para um visitante dos EUA, pt-BR (para o Reino Unido). O Google trata um conjunto de tags hreflang como um único grupo, e um grupo só é válido se todas essas regras forem cumpridas simultaneamente.

1. Cada página faz referência a si mesma

Cada versão linguística deve incluir uma tag hreflang que aponte para seu próprio URL, além de tags para todas as outras versões. A página em inglês lista o inglês (ela própria), o francês, o alemão e x-padrão. A inclusão da autorreferência é imprescindível; caso contrário, o cluster ficará incompleto e você encontrará erros de hreflang imediatamente.

2. As menções são recíprocas (menções de retorno)

Se a sua página em inglês apontar para a versão em francês, a versão em francês deve apontar de volta para a versão em inglês. Essas são chamadas de tags de retorno e devem estar presentes nos dois sentidos em todas as páginas do cluster. Quando falta uma tag de retorno, o Google pode descartar completamente a anotação, em vez de tentar adivinhar.

3. Existe um valor padrão

O x-padrão A tag é a opção alternativa para visitantes cujo idioma ou região você não tenha definido explicitamente. Normalmente, ela direciona para a sua página principal ou para um menu de seleção de idioma. Todos os modelos e ferramentas de SEO destacam essa tag, e por um bom motivo: sem ela, os mecanismos de busca não têm uma opção padrão para recorrer.

4. Os códigos de idioma e região são válidos

Os códigos de idioma seguem a norma ISO 639-1 (pt, fr, de, es, zh). O código de região opcional segue a norma ISO 3166-1 Alpha-2 (US, GB, FR), e os dois se combinam na forma idioma-REGIÃO, como en-GB. Um código de região isoladamente não é válido; o idioma sempre vem primeiro.

Cuidado ao presumir os códigos de idioma e sempre consulte a lista com antecedência. Por exemplo, se você quiser definir sua página como inglês do Reino Unido, o código é pt-BR em vez de pt-BR. O código inteiro está incorreto; UK é o código do idioma para o ucraniano (e seu código de país é UA), portanto, o formato desse código é essencialmente "idioma-idioma", e não "idioma-região".

5. Os URLs são absolutos

Os URLs com hreflang precisam conter o endereço completo, incluindo o protocolo (https://example.com/fr/page/), e não um caminho relativo como /fr/page/. URLs relativos são uma das causas mais comuns de falhas imperceptíveis.

6. As tags canônicas estão alinhadas

A tag canônica de cada versão deve apontar para si mesma, e não para o idioma original. Uma tag canônica que redirecione a página em francês para a página em inglês indica ao Google que ignore a versão em francês, o que anula o trabalho feito com hreflang e faz com que a página errada seja classificada para uma palavra-chave no idioma errado. É por isso que tags canônicas autorreferenciadas e hreflang autorreferenciados andam de mãos dadas.

Um exemplo correto

Um conjunto válido tem a seguinte aparência no <head> de uma página em inglês que também existe em francês, com um recurso alternativo x-default:

<link rel="alternate" hreflang="en" href="https://example.com/page/" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page/" />

A versão em francês em https://example.com/fr/page/ contém as mesmas três tags, apontando para os mesmos URLs. É essa simetria que torna o cluster válido. Escolha um local para colocar as tags (o <head>, um mapa do site em XML ou cabeçalhos HTTP) e mantenha a consistência. No WordPress, o <head> é a opção mais comum.

Erros que prejudicam sua tag hreflang

A maioria das configurações de hreflang com erros falha em um desses pontos, mesmo que as tags pareçam estar corretas no código-fonte da página o tempo todo.

  • Faltam tags de retorno. A página A aponta para B, mas B não aponta de volta. A ausência de tags recíprocas é a razão mais comum pela qual o Google ignora uma configuração que, de resto, estaria correta.
  • Sem autorreferência. Uma página lista suas versões alternativas, mas esquece de se incluir no conjunto. É como contar quantas pessoas há no grupo para uma reserva de jantar e esquecer de se incluir na contagem.
  • URLs relativas. /fr/página/ em vez de https://example.com/fr/page/. Embora pareça razoável, simplesmente não funciona.
  • Códigos inválidos. “en-UK” em vez do correto “en-GB”, sublinhados em vez de hífens (en_US) ou códigos que não existem. Sempre verifique bem seus códigos; essa é a maneira mais fácil de evitar erros.
  • Conflitos canônicos. A URL canônica de uma página traduzida aponta para a versão no idioma original, o que indica aos mecanismos de busca que a tradução não é a página a ser indexada.
  • Dois métodos ao mesmo tempo. Um plugin multilíngue gera o atributo hreflang, enquanto um plugin de SEO separado ou snippet inserido manualmente snippet um segundo conjunto conflitante. Você acabará com tags duplicadas ou incompatíveis que confundem os rastreadores. Use apenas um método.
  • Não x-padrão. Não haver uma alternativa para idiomas e regiões não correspondentes.

Se você estiver adicionando hreflang manualmente em mais do que algumas páginas, cada uma dessas tarefas aumenta proporcionalmente ao número de páginas, e é por isso que a configuração manual se torna rapidamente complicada.

Como verificar se a sua configuração está correta

Verifique se as tags são válidas antes de considerá-las confiáveis, e não depois que as classificações mudarem.

Uma observação rápida antes de mais nada: o Google retirou o relatório específico de segmentação internacional do Search Console em 2022; portanto, a recomendação antiga de “verificar o relatório de hreflang no Search Console” não se aplica mais. O Google continua oferecendo suporte total e interpretando o hreflang; a única mudança foi que os relatórios foram transferidos para outro local. As ferramentas que funcionam atualmente são:

  • InspeçãoGoogle Search Console . Verifique se as URLs alternativas retornam um status 200, são indexadas e não estão sendo substituídas por uma URL canônica inesperada.
  • Screaming Frog SEO Spider. Ele extrai grupos de hreflang, rastreia URLs alternativas e identifica a ausência de tags de retorno, códigos inválidos e inconsistências em todo o site. A maneira mais rápida de realizar auditorias em grande escala.
  • Um validador hreflang específico (como o nosso). Várias ferramentas gratuitas verificam se há reciprocidade e se o código está válido no conjunto de URLs de um único endereço, o que é útil para verificações pontuais.
  • Auditorias de sites com o Ahrefs ou o Sitebulb. Ambas incluem verificações internacionais que sinalizam erros de hreflang como parte de um rastreamento técnico mais abrangente.

Faça uma verificação após qualquer grande atualização ou alteração no modelo, pois é nessas ocasiões que os clusters tendem a apresentar falhas.

A maneira mais rápida de acertar: deixe que um plugin cuide disso

Todas as regras acima podem ser aplicadas manualmente, e em um site pequeno isso é perfeitamente viável. O problema é que é fácil acertar 90% das configurações do hreflang e ainda assim ter falhas, pois as regras são interdependentes e complexas de acompanhar. Uma única tag de retorno faltando pode comprometer um conjunto que, de outra forma, seria perfeito, e encontrar o culpado significa vasculhar meticulosamente o código – e quem quer gastar seu precioso tempo fazendo isso?

É por isso que a maioria dos sites do WordPress usa um plugin multilíngue que gera hreflang automaticamente. Com Weglot, as tags são criadas e mantidas em sincronia à medida que você adiciona idiomas e publica conteúdo: tags de autorreferência, tags de retorno recíproco, x-padrão, códigos válidos e URLs absolutas, seguindo as melhores práticas de SEO multilíngue estabelecidas pelo Google. Dessa forma, você não precisa atualizar manualmente cada página; o plugin faz isso e se atualiza sempre que o seu conteúdo for alterado.

Seja qual for a abordagem que você escolher, as regras permanecem as mesmas. Um plugin apenas as aplica automaticamente para você, de modo que uma tag de retorno ausente nunca lhe custará uma venda.

Configurar o hreflang corretamente resume-se a algumas regras aplicadas de forma consistente em todas as páginas, e os erros são previsíveis assim que você sabe o que procurar. Se você preferir não supervisionar manualmente esses conjuntos à medida que seu site cresce, Weglot os Weglot e sincroniza automaticamente para você. Comece seu teste gratuito de 14 dias e tenha um site multilíngue e otimizado para os mecanismos de busca em poucos minutos.

ícone de direção
Descubra a Weglot

Coisas boas vêm para aqueles que esperam. O tráfego internacional não.

Colocaremos seus primeiros idiomas em funcionamento. Você decide até onde deseja ir. Experimente Weglot hoje mesmo.

Neste artigo, vamos explorar:
Ícone do foguete

Pronto para começar?

A melhor maneira de compreender o poder do Weglot experimentá-lo você mesmo. Teste-o gratuitamente e sem qualquer compromisso.

Um site de demonstração está disponível no seu painel de controle, caso ainda não esteja pronto para conectar o seu site.

Leia artigos que você também pode gostar

Ícone de Perguntas Frequentes

Perguntas comuns

Preciso usar o atributo hreflang se tiver apenas um idioma?

seta

Não. O atributo hreflang só é relevante quando você tem o mesmo conteúdo em mais de um idioma ou região. Um site com um único idioma não precisa dele.

Onde devo colocar as tags hreflang no WordPress?

seta

O <head> da cada página é o método mais comum e mais fácil no WordPress. Você também pode usar um mapa do site em XML ou cabeçalhos HTTP, mas escolha um método e aplique-o de forma consistente em todo o site.

Qual é a diferença entre hreflang="en" e hreflang="en-US"?

seta

pt destina-se a todos os falantes de inglês, independentemente do país. en-US destina-se especificamente aos falantes de inglês nos Estados Unidos. Use o código de região apenas quando você realmente oferecer conteúdo diferente para regiões diferentes, como lojas separadas para os EUA e o Reino Unido.

Por que o Google está ignorando minhas tags hreflang?

seta

A causa mais comum é a ausência de uma tag de retorno (as páginas não apontam umas para as outras) ou um conflito de canônicas (a canônica de uma página traduzida aponta para a versão no idioma original). Ambos podem fazer com que o Google desconsidere a anotação. Verifique primeiro a reciprocidade e as canônicas.

O hreflang ajuda diretamente no meu SEO?

seta

Isso, por si só, não melhora a classificação nos resultados de busca. O que faz é garantir que a versão no idioma correto seja exibida para o usuário certo, o que melhora a experiência e evita que suas páginas traduzidas entrem em concorrência entre si nos resultados de busca.

Seta azul

Seta azul

Seta azul