Hreflang é a anotação que indica as versões alternativas de uma página por idioma ou região, para que o Google mostre a URL adequada a cada pessoa. Ela não traduz conteúdo nem define o idioma da página: para isso, o Google usa seus próprios algoritmos, sem depender da anotação ou do atributo lang.
Quando a marcação faz diferença
- Site totalmente traduzido, com a mesma página em português e espanhol.
- Mesma língua com variações regionais, como pt-BR e pt-PT com preço, frete ou moeda diferentes.
- Conteúdo principal em um idioma e template traduzido em outro.
- Não se aplica a sites com uma única versão de idioma e região.
Regras de implementação
- Escolha um método: link no head, cabeçalho HTTP Link ou sitemap. Para o Google, os três são equivalentes; o cabeçalho serve bem a PDFs.
- Em cada versão, liste a si mesma e todas as outras, com o mesmo conjunto em todas as páginas.
- Use URLs completas, com protocolo.
- Use idioma em ISO 639-1 e, se precisar, região em ISO 3166-1 Alfa 2: pt-BR é válido; apenas BR não, porque seria lido como idioma.
- Acrescente x-default para o seletor de país ou a página de fallback.
Um par de páginas Brasil e Portugal
Uma loja hipotética mantém /pt-br/tenis/ e /pt-pt/tenis/, com conteúdo quase igual e preços em moedas diferentes. Cada uma aponta para si mesma como canonical, e não para a outra, e ambas trazem as duas anotações hreflang mais o x-default. Se a versão portuguesa tivesse canonical para a brasileira, a mensagem seria contraditória: uma URL pedindo para ser mostrada a um público e, ao mesmo tempo, ser substituída.
Reciprocidade quebrada e redirecionamento por IP
A falha mais comum é a anotação de mão única: se a página A cita a B e a B não cita a A, a tag é ignorada. Outro problema frequente é redirecionar automaticamente por idioma ou IP. O Googlebot rastreia sobretudo a partir dos Estados Unidos e pode nunca alcançar as demais versões, então ofereça links visíveis para a escolha. Para conferir o resultado, leia as anotações no código de uma amostra por template e veja, na Inspeção de URL, qual canônica foi selecionada. Mesmo correto, o hreflang é uma indicação, sem controle total sobre a versão exibida.
Referência técnica
Para aprofundar, consulte documentação do Google sobre versões localizadas ↗. A SEOZILLA também disponibiliza ferramentas de SEO e um diagnóstico inicial gratuito.
Perguntas frequentes
Preciso de domínio .pt para atingir Portugal?
Não. Domínio de país, subdomínio e subdiretório são opções aceitas, com custos e manutenção diferentes. O Google não recomenda parâmetros de URL para definir região, porque dificultam a segmentação.
Posso apontar hreflang para outro domínio meu?
Sim, as versões alternativas não precisam estar no mesmo domínio. Só é preciso que a relação de ida e volta seja mantida em todas as páginas.