Pular para o conteúdo principal
← Todos os guias

Hreflang

O hreflang diz a um buscador que várias páginas são o mesmo conteúdo para públicos diferentes, para que ele sirva a certa. É um sinal que ele pode optar por não seguir, não uma diretiva que precise obedecer.

Quatro regras que mantêm o conjunto interpretável

O Google avalia as relações hreflang entre URLs. Se X aponta para Y, mas Y não aponta de volta, o Google pode ignorar essa relação e continuar processando outros pares recíprocos válidos. Ainda vale manter conjuntos completos e autorreferentes para cobrir todas as versões.

  • Completo: cada versão do grupo lista todas as outras.
  • Mútuo: se X apontar para Y, Y deverá apontar de volta para X. Links de retorno ausentes podem fazer com que as anotações sejam ignoradas ou interpretadas incorretamente.
  • Autorreferente: cada página se lista junto das demais.
  • Válido: os códigos precisam ler como códigos reais de idioma e região.

A regra de mutualidade é aquela que pega as equipes, porque hreflang descreve relacionamentos entre páginas em vez de uma propriedade de uma página isoladamente. Distribua os links de retorno correspondentes para que cada relacionamento publicado seja concluído quando o Google rastrear qualquer um dos lados.

Onde colocar as anotações

Há três colocações disponíveis e o efeito delas é equivalente. Escolha uma e use em todo lugar — misturá-las pelo site é como os conjuntos acabam declarados pela metade.

MétodoMelhor paraFique de olho em
Elementos link em HTMLSites pequenos e médiosO peso da página quando há muitas versões
Cabeçalhos HTTPPDFs e outros arquivos não HTMLLimites de tamanho de cabeçalho em conjuntos grandes
Entradas de sitemapSites grandes, muitos idiomasMantê-las em sincronia com as próprias páginas
Elementos link em HTML
<link rel="alternate" hreflang="en" href="https://example.com/guide/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/guide/" />
<link rel="alternate" hreflang="pt-br" href="https://example.com/pt-br/guide/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/guide/" />

A página em inglês do exemplo também lista a si mesma. É a autorreferência. Ela pode parecer redundante ao limpar o template, mas o Google pede que cada versão inclua a própria URL.

Códigos, e os que não existem

Os códigos de idioma seguem a ISO 639-1, com região opcional pela ISO 3166-1 Alpha 2. Uma região sozinha não basta. O Google também aceita códigos de escrita como zh-Hans e zh-Hant (ISO 15924), opcionalmente com região.

CódigoVereditoPor quê
ptVálidoSó idioma — português, qualquer região
pt-BRVálidoPortuguês como escrito para o Brasil
BRInválidoRegião sem idioma
ukVálido, mas não é o Reino Unidouk é ucraniano; o Reino Unido é GB
euInválido como regiãoA UE não é um código de país
en-UKInválidoO código de país do Reino Unido é GB

Para que serve o x-default

O x-default recolhe os idiomas que você não listou. É o recurso para um visitante cujo idioma não bate com nenhuma das suas versões, e o lugar natural dele é uma página seletora ou uma home que roteia os visitantes sozinha.

Não é jeito de nomear uma versão principal. Apontar o x-default para sua página em inglês porque inglês soa como padrão diz ao buscador que um visitante japonês ou turco sem correspondência deve receber inglês. Pode ser verdade, e vale decidir isso de propósito, não por hábito.

Hreflang e canônica são trabalhos diferentes

Canonical é um sinal forte de qual URL deve representar páginas duplicadas ou muito semelhantes. Hreflang indica variantes de idioma e região. Nenhum dos dois é uma ordem absoluta de indexação.

Se o canonical de uma tradução alemã apontar para a página em inglês, o Google poderá escolher a URL inglesa, limitando a visibilidade independente da alemã e complicando suas relações hreflang. Para traduções distintas, prefira canonicals autorreferentes e hreflang recíproco. Para versões regionais quase duplicadas no mesmo idioma, o Google recomenda escolher um canonical preferencial nesse idioma.

Teste no seu próprio site

Gerador de slug: crie URLs limpas e legíveis — Transforme títulos em slugs de URL com hífens e letras minúsculas. Acentos e outros alfabetos permanecem intactos. Grátis, sem cadastro e no navegador.

Perguntas e respostas

O hreflang resolve conteúdo duplicado entre idiomas?

É um sinal de segmentação, não um conserto de conteúdo duplicado. Traduções não são duplicatas; o hreflang diz ao buscador qual tradução pertence a qual público.

Por que a versão de idioma errada está ranqueando?

Confira links de retorno, códigos de idioma e região, canonicals e o idioma real da página. O Google pode ignorar um par sem reciprocidade e continuar processando outros pares válidos; detecta o idioma pelo conteúdo, não pelo hreflang.

Preciso de hreflang se todas as minhas páginas estão em um idioma?

Use hreflang quando URLs diferentes atendem regiões diferentes, como pt-BR e pt-PT, mesmo que o conteúdo no mesmo idioma seja muito parecido. Uma versão para um único público não precisa dele.

Cada página deve canonizar para si mesma ou para o idioma original?

Para traduções distintas, use canonical para a própria página, não para o idioma de origem. O Google trata canonicals como sinais fortes, não ordens; um canonical entre idiomas pode limitar a visibilidade independente. Para duplicatas regionais no mesmo idioma, escolha um canonical preferido nesse idioma.

Para onde o x-default deve apontar?

Para o que deva atender um visitante cujo idioma você não publica — normalmente uma página seletora ou uma home que se roteia sozinha. Ele nomeia um recurso de reserva, não uma versão principal.

O hreflang é fator de ranqueamento?

Não. É um sinal de segmentação que ajuda a versão certa a alcançar o público certo. Não eleva o ranqueamento de uma página, e o Google pode não seguir as anotações.