Hreflang para sites multilinguais - As regras que realmente quebram

Hreflang diz aos motores de busca qual URL e a versao de idioma (ou regiao) de uma pagina. Feito certo, cada locale pode ranquear para o publico certo. Feito errado, falhas silenciosas: faltam tags de retorno, codigos errados como en-UK, ou sinais HTML e sitemap misturados que se contradizem. Este guia parte do setup real do ToolsMinify - ingles sem prefixo, /es /pt /fr /de, e x-default apontando para o ingles - nao de uma checklist generica.

Resposta rapida

Cada URL do cluster deve listar todos os alternates, incluindo a si mesma. Cada alternate deve listar os outros de volta. Escolha um unico metodo de entrega (links HTML, cabecalhos HTTP ou xhtml:link no sitemap) e mantenha-o. Use codigos BCP 47 validos (en-GB, nunca en-UK). Trate hreflang como uma dica forte, nao uma garantia. Monte e valide clusters com o Gerador de tags Hreflang.

Como o ToolsMinify publica cinco idiomas

O site ao vivo usa o mesmo slug por pagina em cada idioma. O ingles nao tem prefixo /en. Os outros idiomas mantem o mesmo caminho apos o prefixo de locale.

Ingles (padrao): https://www.toolsminify.com/seo-tools/hreflang-tag-generator
Espanhol: https://www.toolsminify.com/es/seo-tools/hreflang-tag-generator
Portugues: https://www.toolsminify.com/pt/seo-tools/hreflang-tag-generator
Frances: https://www.toolsminify.com/fr/seo-tools/hreflang-tag-generator
Alemao: https://www.toolsminify.com/de/seo-tools/hreflang-tag-generator
x-default: a URL em ingles - o fallback quando nenhuma preferencia de idioma corresponde

Os slugs ficam iguais entre locales para o cluster ser facil de gerar e dificil de digitar errado. Quando criar um caminho novo, mantenha-o em minusculas e com hifens com o Gerador de slugs, e depois espelhe esse slug sob cada prefixo de locale.

Autorreferencia: cada pagina lista a si mesma

O Google espera que cada URL do conjunto inclua um link para si mesma com o proprio codigo hreflang. A pagina em portugues nao e anunciada so a partir do ingles - o HTML (ou entrada de sitemap) em portugues tambem deve dizer hreflang="pt" apontando para a URL em portugues.

Na pagina EN: inclua hreflang="en" com a URL EN, mais es, pt, fr, de e x-default.
Na pagina PT: o mesmo conjunto completo, incluindo hreflang="pt" com a URL PT.
Faltar a autorreferencia e uma das falhas silenciosas mais comuns. O cluster parece completo em uma pagina e incompleto em outra.

O Gerador de tags Hreflang emite o conjunto completo de alternates para cada URL em formas HTML e sitemap, para a autorreferencia nao ser um detalhe opcional.

Tags de retorno reciprocas

Se a pagina A aponta a pagina B como alternate, a pagina B deve apontar de volta para A. Links de mao unica sao tratados como erros. Um rollout parcial - ingles e portugues no ar, tags francesas apontando para 404 - nao "funciona pela metade". Corrija o cluster inteiro antes de publicar as tags.

Publique todas as URLs de locale que declarar, ou remova os codigos que ainda nao puder suportar.
Mantenha hosts consistentes (www vs apex). Misturar https://toolsminify.com e https://www.toolsminify.com divide o cluster.
As tags canonical devem bater com a URL listada no hreflang. Apontar o canonical para outro host ou variante de barra final enfraquece o sinal.

Reciproco significa o conjunto completo

Nao basta EN linkar para PT e PT para EN. Cada pagina deve listar todos os outros idiomas do cluster. Pense em uma matriz compartilhada, nao em amizades aos pares.

Nao misture metodos HTML e sitemap

Voce pode entregar hreflang de tres formas: <link rel="alternate" hreflang="..."> no head HTML, cabecalhos HTTP Link, ou entradas xhtml:link em um sitemap XML. Escolha um metodo principal por cluster. Misturar tags HTML incompletas com um sitemap diferente e uma forma classica de criar contradicoes que o Google nao resolve bem.

Tags link HTML - uteis quando o layout ja injeta alternates de locale (como os mapas languages de metadata no Next.js).
xhtml:link no sitemap - uteis para grandes conjuntos de URLs gerados a partir de uma unica fonte de verdade.
Cabecalhos HTTP Link - uteis para respostas nao HTML; raros em sites de marketing.
Se mudar de metodo, remova as anotacoes antigas para os crawlers verem uma unica historia.

Sitemaps e regras de crawl ainda importam em outros lugares. Mantenha URLs de locale indexaveis permitidas no robots.txt - veja Melhores praticas de robots.txt para SEO e o Gerador de robots.txt. Nao faca Disallow de /pt/ ou /de/ se essas paginas devem ranquear.

en-GB nao en-UK (e outras armadilhas de codigo)

Os codigos hreflang seguem ISO 639-1 de idioma, opcionalmente mais ISO 3166-1 de regiao. O codigo de regiao do Reino Unido e GB, nao UK. en-UK e invalido. O gerador deste site marca en-UK e sugere en-GB.

So idioma: en, es, pt, fr, de - ok quando voce nao precisa de segmentacao por pais.
Idioma + regiao: en-GB, en-US, pt-BR, es-MX - use quando o conteudo realmente difere por pais.
x-default - valor especial para a URL de fallback quando nenhum outro codigo corresponde. No ToolsMinify e a URL em ingles (sem prefixo).
Nao invente codigos. zh-CN e zh-TW sao padroes validos; regioes inventadas nao.

O ToolsMinify usa codigos de idioma simples (en, es, pt, fr, de) porque o mesmo artigo e publicado para cada regiao que fala aquele idioma. Adicione um sufixo de regiao so quando mantiver paginas separadas por pais.

Hreflang e uma dica, nao uma diretiva

Hreflang nao forca o Google a mostrar a URL em portugues no Brasil ou a alema na Alemanha. E um sinal forte de segmentacao por idioma. O Google ainda pode escolher outra URL se achar que aquele resultado e melhor para o usuario - por exemplo quando a pagina em portugues e fraca, bloqueada ou mais lenta.

Traduza (ou localize bem) o conteudo. Cascas vazias com hreflang ainda falham com usuarios e sistemas de qualidade.
Mantenha titulos, meta descriptions e texto visivel no idioma de destino.
Nao use hreflang para tapar paginas inglesas duplicadas sob URLs /pt.
Monitore os relatorios de segmentacao internacional / hreflang no Search Console depois de publicar um cluster.

Dica vs garantia

Tags corretas removem confusao. Elas nao substituem rastreabilidade, qualidade ou relevancia. Corrija robots, canonicals e conteudo primeiro - depois anote o cluster.

Um cluster de exemplo do ToolsMinify

Para a propria pagina da ferramenta hreflang, o head HTML deve incluir (URLs https absolutas, uma linha por alternate):

<link rel="alternate" hreflang="en" href="https://www.toolsminify.com/seo-tools/hreflang-tag-generator" />
<link rel="alternate" hreflang="es" href="https://www.toolsminify.com/es/seo-tools/hreflang-tag-generator" />
<link rel="alternate" hreflang="pt" href="https://www.toolsminify.com/pt/seo-tools/hreflang-tag-generator" />
<link rel="alternate" hreflang="fr" href="https://www.toolsminify.com/fr/seo-tools/hreflang-tag-generator" />
<link rel="alternate" hreflang="de" href="https://www.toolsminify.com/de/seo-tools/hreflang-tag-generator" />
<link rel="alternate" hreflang="x-default" href="https://www.toolsminify.com/seo-tools/hreflang-tag-generator" />

Esse mesmo conjunto completo deve aparecer em cada URL de locale da pagina - nao so em ingles. Cole um cluster no linter do gerador para pegar autorreferencias faltantes e links de mao unica antes do deploy.

Erros comuns que quebram clusters

hrefs relativos (/pt/page) em vez de URLs https absolutas.
en-UK, typos em pt-BR, ou codigos de idioma que nao batem com o idioma da pagina.
Declarar um locale que da 404 ou redireciona para outro idioma.
Misturar www e nao-www, ou http e https, dentro do mesmo cluster.
Bloquear prefixos de locale no robots.txt enquanto os lista no hreflang.
Publicar tags HTML e um conjunto de sitemap conflitante para as mesmas URLs.

Perguntas frequentes

Preciso de hreflang se so tenho ingles?

Nao. Hreflang e para URLs alternativas de idioma ou regiao. Um site de um so idioma deve focar em canonicals, sitemap e um atributo lang claro no HTML.

x-default deve ser uma pagina "global" separada?

So se voce mantiver um verdadeiro seletor de idioma ou landing global. Muitos sites, incluindo o ToolsMinify, apontam x-default para a URL do idioma padrao (ingles). E valido e mais facil de manter reciproco.

en-UK e aceitavel alguma vez?

Nao. Use en-GB para ingles britanico. UK nao e um codigo de pais ISO 3166-1 para este proposito.

Posso colocar hreflang so no sitemap?

Sim - entregar so pelo sitemap e valido se cada entrada de URL listar o conjunto completo de alternates. Nao publique tambem um conjunto HTML incompleto e conflitante. Prefira um metodo e mantenha-o completo.

Hreflang substitui o geotargeting no Search Console?

Nao. Hreflang anota idioma e regiao opcional no nivel da URL. O targeting por pais de toda uma propriedade e um ajuste separado (e muitas vezes desnecessario) quando voce ja usa hreflang correto.

Monte e valide hreflang no ToolsMinify

Cada ferramenta abaixo roda no seu navegador - gratis, sem cadastro, nada enviado:

Gerador de tags Hreflang - gera saida HTML, sitemap e HTTP Link e valida autorreferencias e tags de retorno.
Gerador de robots.txt - mantenha caminhos de locale rastreaveis enquanto bloqueia so o que deve ficar privado.
Gerador de slugs - crie slugs em minusculas com hifens para reutilizar sob cada prefixo de locale.
Todas as ferramentas SEO - o indice completo da categoria.

Teste gratis

Insira suas URLs EN / ES / PT / FR / DE no Gerador de tags Hreflang, ative x-default no ingles e copie o bloco HTML ou sitemap. Tudo fica no seu dispositivo.