Gerador de hreflang e validador

O hreflang avisa aos buscadores que uma página tem versões em outros idiomas ou para outros países. O Google usa esses links para mostrar a cada usuário a versão certa: quem busca no Brasil vê /br/precos em reais, quem busca em Portugal vê /pt/precos em euros. Não é um fator de ranqueamento em si: ajuda a escolher qual URL mostrar.

O Google aceita três métodos de marcação equivalentes:

O valor do atributo é um código de idioma ISO 639-1, opcionalmente seguido de um código de país ISO 3166-1 alfa-2 depois de um hífen: pt, pt-BR, pt-PT. O valor especial x-default marca a página para todos os demais: um seletor de idioma ou a versão principal.

Um site num só idioma e para um só mercado não precisa de hreflang. Ele é necessário quando a mesma página existe em várias variantes: traduções, versões regionais com preços e moedas diferentes, ou versões em português para o Brasil e para Portugal com vocabulário adaptado.

Reciprocidade e autorreferência

A regra principal da documentação do Google: os links precisam ser recíprocos. Se a versão de Portugal aponta para a do Brasil, a do Brasil precisa apontar de volta; senão a marcação pode ser ignorada. Além disso, cada versão lista a si mesma. O jeito mais simples é colocar o mesmo conjunto completo em todas as versões — exatamente o que o gerador monta.

Códigos

• O idioma é sempre obrigatório; o país, só junto com o idioma. hreflang="BR" é erro — use pt-BR.
• Cuidado com br em minúsculas: é um código de idioma válido, mas é o bretão. A ferramenta não marca como erro, porque o código existe.
• O separador é o hífen. pt_BR aparece em locales de software e no og:locale, mas no hreflang o certo é pt-BR.
• Um idioma sem país funciona como reserva para todos os países. Se você tem pt-BR e pt-PT, adicione pt para quem fala português em Angola, Moçambique ou em qualquer outro lugar.

hreflang e canonical

Cada versão precisa ser canônica de si mesma. Um erro comum é apontar o rel="canonical" da versão de Portugal para a do Brasil porque os textos são parecidos: isso declara a versão portuguesa como duplicata, e os buscadores podem não mostrá-la. O canonical aponta para a página da mesma variante; o hreflang descreve a relação entre elas. As URLs do hreflang precisam coincidir com as canônicas: sem parâmetros extras, mesmo protocolo e mesma barra final.

URLs

Use URLs completas, com protocolo e domínio: https://example.com/pt/, não /pt/. As versões podem ficar em domínios diferentes (example.com.br, example.pt) — o hreflang funciona entre domínios. As páginas do conjunto devem responder 200 e não podem estar bloqueadas para indexação.

O Google se apoia no hreflang. O Bing historicamente recomenda o atributo lang do HTML ou a meta tag content-language e uma estrutura de URL clara, e dá menos peso ao hreflang. Na prática, use tanto o atributo lang quanto o hreflang.

Domínios de país, subdomínios ou subpastas

O guia do Google para sites multirregionais e multilíngues compara as opções assim:

• Domínios de país (example.com.br, example.pt) — o sinal de país mais claro, mas cada domínio precisa ser comprado, mantido e fortalecido separadamente.
• Subdomínios (br.example.com) — fáceis de hospedar separadamente; a ligação com o site principal fica menos óbvia para o usuário.
• Subpastas (example.com/br/) — as mais fáceis de manter: um host, histórico de domínio compartilhado. Para SaaS costuma ser a opção mais prática.
• Parâmetros de URL (?lang=pt) não são recomendados pelo Google: dificultam saber qual versão o usuário está vendo.

Seja qual for a escolha, não redirecione usuários automaticamente por IP ou idioma do navegador. Os robôs podem nunca ver as outras versões, e as pessoas podem não chegar à que queriam. Mostre um seletor de idioma visível e deixe o hreflang indicar a URL certa aos buscadores.

• Sem links de volta. A marcação foi colocada só na versão principal — as outras não apontam de volta.
• Sem autorreferência. A página lista todas as versões menos ela mesma.
• Códigos inválidos: pt_BR, BR sem idioma, br achando que é Brasil (é bretão), códigos de três letras como por.
• URLs relativas, ou com parâmetros de rastreamento e #fragmentos.
• Canonical para outra variante. A versão de Portugal fica declarada como duplicata da do Brasil.
• Versões bloqueadas para indexação no robots.txt ou com noindex — o link aponta para uma página que o buscador não pode usar.
• Um código, duas URLs. Duas URLs diferentes com hreflang="pt-BR" no mesmo conjunto.
• Páginas não adaptadas. Uma versão “de Portugal” idêntica à do Brasil, com “celular” e preços em reais, é duplicata, não versão regional.
• Marcação em vários lugares que não bate: um conjunto no HTML, outro no sitemap.

1. Google Search Central. Informar ao Google sobre versões localizadas da sua página — developers.google.com/search/docs/specialty/international/localized-versions.
2. Google Search Central. Gerenciar sites multirregionais e multilíngues — developers.google.com/search/docs/specialty/international/managing-multi-regional-sites.
3. ISO 639-1:2002. Codes for the representation of names of languages — Part 1: Alpha-2 code; registro — loc.gov/standards/iso639-2.
4. ISO 3166-1. Codes for the representation of names of countries — iso.org/iso-3166-country-codes.html.
5. RFC 5646 (BCP 47). Tags for Identifying Languages. IETF, 2009.
6. Sitemaps.org. Sitemap protocol — sitemaps.org/protocol.html.
7. Bing Webmaster Blog. How to optimize your content for search in multiple languages and regions — blogs.bing.com/webmaster.