Utilia

Gerador de etiquetas hreflang

Gera etiquetas hreflang para páginas multilíngues em HTML, entradas de sitemap XML ou cabeçalhos HTTP Link, com verificação dos códigos ISO e da reciprocidade.

Versões linguísticas por exemplo pt, pt-PT, pt-BR, zh-Hant
Coloca o mesmo conjunto completo em todas as páginas listadas, incluindo a própria página.

Verificações

Verificar as etiquetas atuais de uma página

Cola as etiquetas hreflang, as entradas de sitemap ou o cabeçalho Link que uma das tuas páginas serve atualmente, para os comparar com o conjunto acima.

Como usar o gerador de hreflang

  1. Em Versões linguísticas, introduz uma linha por versão da página: um Código de língua como pt, pt-PT ou pt-BR, e o URL da página absoluto dessa versão. Usa Adicionar uma língua para teres mais linhas.
  2. Se quiseres, preenche o URL x-default, a página mostrada aos visitantes cuja língua não corresponde a nenhuma das tuas versões.
  3. Escolhe o Formato de saída: Etiquetas HTML link, Sitemap XML ou Cabeçalho HTTP Link.
  4. Lê as Verificações e depois usa Copiar ou Transferir para obter o código. Coloca o mesmo conjunto completo em todas as páginas listadas.
  5. Para auditar uma página publicada, abre Verificar as etiquetas atuais de uma página, cola o que a página serve atualmente e introduz o URL dela. A ferramenta lista as entradas em falta, a mais e diferentes.

Carregar exemplo mostra uma configuração com quatro versões em inglês e francês e um x-default.

O que faz o hreflang

O hreflang indica aos motores de busca que vários URL são versões do mesmo conteúdo para línguas ou regiões diferentes, para que cada pessoa veja a versão certa. Não muda o posicionamento nem redireciona ninguém; apenas ajuda a Google e o Yandex a escolher que versão mostrar nos resultados. O Bing baseia-se sobretudo na meta tag content-language e no atributo lang.

Cada valor é um código de língua ISO 639-1 (duas letras, como pt), opcionalmente seguido de uma região ISO 3166-1 alfa-2 (como BR para o Brasil). Também é aceite um sistema de escrita, como zh-Hant. A região não pode ser usada sozinha: CA significa catalão, não Canadá, e PT sozinho é lido como a língua portuguesa, não como Portugal. Para o português de Portugal, escreve pt-PT; para o do Brasil, pt-BR. Esta ferramenta valida as duas partes com listas de códigos incluídas, escreve-as com as maiúsculas habituais (pt-PT, mesmo que escrevas PT_pt) e apanha erros clássicos como en-UK (o Reino Unido é GB) ou códigos retirados como iw para hebraico (agora he).

Os três formatos de saída

  • As Etiquetas HTML link vão no <head> de cada versão. É a opção mais simples para páginas web normais.
  • O Sitemap XML coloca as anotações no teu sitemap: uma entrada <url> por página, cada uma a listar todas as alternativas com xhtml:link. Mantém o HTML leve e é mais fácil de gerir em sites grandes.
  • O Cabeçalho HTTP Link serve para ficheiros sem <head>, como os PDF. O teu servidor envia o cabeçalho com o ficheiro.

Usa um único método por página. Misturá-los é permitido, mas torna os erros mais prováveis.

Reciprocidade: a regra que a maioria dos sites falha

As anotações têm de ser bidirecionais. Se a página A diz que B é a sua versão francesa, B também tem de apontar de volta para A, caso contrário os motores de busca ignoram o par. Cada página tem também de se listar a si própria. A forma mais simples de acertar nas duas coisas é pôr exatamente o mesmo bloco em todas as versões, que é o que esta ferramenta gera. O painel Verificar as etiquetas atuais de uma página compara as etiquetas atuais de uma página com o teu conjunto e indica ligações de retorno em falta, a autorreferência em falta e URL diferentes, por exemplo por causa de uma barra final ou de http em vez de https.

Perguntas frequentes

O x-default é obrigatório?

Não, mas é recomendado. Indica a página de recurso para todos os outros visitantes, normalmente um seletor de língua ou a tua versão principal. Tem de seguir as mesmas regras que as outras entradas, incluindo estar listado em todas as páginas.

Devo acrescentar uma língua genérica além das regionais?

Normalmente sim. Se só tiveres pt-PT e pt-BR, um falante de português em Angola não corresponde a nenhuma das duas. Acrescentar uma versão pt simples cobre esses casos, e esta ferramenta avisa quando uma língua só tem variantes regionais.

Duas línguas podem apontar para o mesmo URL?

Sim. Por exemplo, pt-PT e pt-AO podem partilhar uma página quando o conteúdo é idêntico. Cada valor hreflang, no entanto, só pode aparecer uma vez no conjunto.

Os URL têm de ser absolutos?

Sim. A Google exige URL completos, incluindo https://. Os caminhos relativos são recusados aqui. Um fragmento como #topo é ignorado pelos motores de busca.

O hreflang substitui a etiqueta canónica?

Não, trabalham em conjunto. Cada versão deve ter um canónico que aponte para si própria, não para outra versão linguística. Um canónico para uma língua diferente diz à Google para descartar essa página, e o hreflang dela é ignorado.