A tag hreflang é uma marcação que informa ao Google que o mesmo conteúdo existe em diferentes versões de idioma ou região, indicando "qual usuário deve ver qual versão". Em um site com versões em português e inglês, um visitante que fala inglês não deve receber a página em português, e quem busca em português não deve cair na página em inglês; ambos os casos fazem você perder o usuário e a visita. Um hreflang bem configurado reduz essa confusão. Já quando está errado, o Google pode ignorar todas as tags. Neste artigo, tratamos da configuração, dos códigos e dos erros mais comuns, passo a passo.
O que é a tag hreflang?
O hreflang é um link rel="alternate" que lista as "versões alternativas" de uma página. Cada versão
mostra todas as outras versões e a si mesma, junto com o código do idioma. Quando o Google vê esse conjunto, ele
mostra nos resultados o endereço mais adequado ao idioma e à região de quem está pesquisando.
Uma distinção importante: o hreflang não é um fator de melhora de posicionamento. Ele não define em que posição sua página vai aparecer; apenas ajuda a escolher a versão correta entre versões que já estão indexadas. O Google trata isso como uma dica (hint), não como uma ordem obrigatória. Para mais detalhes sobre a versão canônica, consulte nosso guia da tag canonical.
Pense em um exemplo simples: um mesmo produto é vendido no Brasil e em Portugal. Se um usuário português pesquisa por um termo e recebe a página brasileira, com preço em reais e prazo de entrega do Brasil, a venda se perde. O hreflang, nesse caso, funciona como uma indicação para o Google: "para este usuário, a versão portuguesa é a mais adequada". Se o conteúdo da página e o preço não forem adequados àquela região, a tag sozinha não basta; a tradução e a localização (moeda, unidades de medida, informações de entrega) são igualmente importantes.
Quando é necessária e quando não é?
Considere o hreflang nos seguintes casos:
- Quando a mesma página tem versões traduzidas em mais de um idioma (por exemplo pt, en, de).
- Quando existem versões regionais do mesmo idioma (ex.: as páginas
en-gbeen-us, com preço, moeda e informações de frete diferentes). - Quando você tem páginas de loja ou de serviço diferentes conforme o país.
Já nos casos abaixo, não é necessária: se o seu site é de um só idioma, se as versões têm conteúdos totalmente diferentes entre si, ou se você pretende marcar páginas que não foram traduzidas (que continuam no idioma original). Atribuir um código de idioma diferente a uma página não traduzida transmite informação errada tanto ao usuário quanto ao Google. Revise com cuidado, antes de publicar, as versões geradas por tradução automática; traduções de baixa qualidade e sem revisão causam problemas independentemente do hreflang.
As três formas de adicionar o hreflang
O Google considera os três métodos equivalentes. Escolha o que preferir, mas manter um único método e ser consistente é o mais seguro.
| Método | Onde fica? | Quando é adequado? |
|---|---|---|
<link> em HTML | No <head> de cada página | Sites pequenos e médios, páginas geradas por template |
| Cabeçalho HTTP | No cabeçalho da resposta do servidor (Link:) | Arquivos que não são HTML, como PDFs |
| Sitemap XML | Nos elementos xhtml:link do arquivo sitemap | Sites grandes, com muitas páginas e idiomas; não sobrecarrega o HTML de cada página |
Em sites grandes, o método do sitemap facilita a manutenção, porque todas as correspondências ficam em um único lugar. Para as regras gerais do sitemap, veja nosso guia de sitemap XML.
Exemplo de código: um site em três idiomas
Em um site com versões em português, inglês e alemão, as linhas abaixo são adicionadas ao <head>
da página inicial. As mesmas linhas devem estar presentes nas três versões:
<link rel="alternate" hreflang="tr" href="https://ornek.com/tr/" />
<link rel="alternate" hreflang="en" href="https://ornek.com/en/" />
<link rel="alternate" hreflang="de" href="https://ornek.com/de/" />
<link rel="alternate" hreflang="x-default" href="https://ornek.com/" />
Pontos de atenção:
- Os endereços devem ser completos (absolutos), incluindo https e o nome do domínio.
- Cada página deve listar a si mesma também (autorreferência).
x-defaultindica a página padrão para a sua página de seleção de idioma ou para usuários cujo idioma não está entre as versões. É opcional, mas útil em sites multilíngues.- A tag canonical de cada versão de idioma deve apontar para ela mesma. Apontar o canonical de todos os idiomas para uma única versão torna o hreflang inútil.
A reciprocidade é obrigatória: se a página em português aponta para a versão em inglês, a versão em inglês também deve apontar para a versão em português (o "link de retorno"). As marcações sem correspondência podem ser ignoradas. A grande maioria dos erros de hreflang vem desta regra.
Códigos de idioma e região
O código de idioma é o código de duas letras da norma ISO 639-1 (pt, en, de).
Se quiser, pode acrescentar o código de região da norma ISO 3166-1 Alpha-2 (en-gb,
de-at). A regra é simples: primeiro o idioma, depois a região, se houver.
| Correto | Incorreto | Por que está errado? |
|---|---|---|
en-gb | en-uk | O código ISO de região do Reino Unido é GB, não UK |
en ou en-us | us | Não é possível usar apenas o código de região; o idioma é obrigatório |
pt | portugues | Deve-se usar o código padrão, não o nome do idioma |
pt-br | pt_BR | Usa-se hífen, não sublinhado |
Use o código de região somente quando o mesmo idioma tiver versões realmente diferentes por região. Se você oferece
apenas conteúdo em português do Brasil, escrever pt-br não é necessário; pt basta.
Estrutura de URL para um site multilíngue
O hreflang funciona independentemente da estrutura de URL escolhida, mas a estrutura afeta a manutenção e a medição:
- Subpasta (
ornek.com/en/): gestão simples sob um único domínio; é monitorada como uma só propriedade no Search Console. Na maioria dos sites, é a escolha prática. - Subdomínio (
en.ornek.com): útil quando é preciso um servidor ou equipe separados, mas pode ser necessário monitorá-lo como uma propriedade diferente. - Domínio de país (
ornek.de): deixa o público-alvo mais claro, mas exige montar a autoridade de cada domínio separadamente e aumenta os custos.
Páginas que mudam o idioma apenas por cookie, endereço IP ou configuração do navegador, mantendo a mesma URL, não são consideradas versões diferentes pelo Google. Cada versão de idioma precisa ter um endereço próprio, que possa ser acessado por link. Evite também redirecionar o usuário automaticamente para outra versão de acordo com a localização; os robôs de busca costumam acessar de um único local e podem nunca ver as outras versões. Em vez disso, ofereça um seletor de idioma visível.
Plano de implementação: passo a passo
Ao adicionar o hreflang a um site existente, seguir esta ordem reduz o risco de erros:
- Levante o inventário de páginas. Anote, em uma tabela, quais páginas têm um equivalente real em quais idiomas. Coloque as páginas nas linhas e os idiomas nas colunas; uma célula vazia significa "não há equivalente neste idioma".
- Escolha o método. Para até algumas centenas de páginas, o
<link>em HTML costuma ser suficiente; em sites maiores, o método do sitemap é geralmente mais prático. - Defina os códigos. Decida se basta o idioma ou se é preciso idioma e região, e fixe a lista; mudar isso depois exige reorganizar todas as páginas.
- Automatize no template. O CMS ou o tema deve gerar automaticamente os equivalentes de cada página. As tags escritas à mão se degradam com o tempo.
- Teste primeiro em uma parte pequena. Por exemplo, comece com uma única categoria, verifique com uma ferramenta de rastreamento e depois expanda.
- Monitore depois. Quando uma página nova é adicionada ou uma versão de idioma é removida, as correspondências precisam ser atualizadas; tags antigas que apontam para uma página excluída viram erro.
Se você remover uma versão de idioma, não se esqueça de remover também a linha desse idioma das demais versões. Esses resíduos esquecidos são, com o tempo, a fonte que mais gera erros.
Erros mais comuns
| Erro | Consequência | Solução |
|---|---|---|
| Falta a tag de retorno | A marcação é ignorada | Cada versão deve listar todas as versões |
| O endereço do hreflang redireciona ou retorna 404 | A correspondência não pode ser estabelecida | Use apenas endereços finais que retornem 200 |
| A página indicada no hreflang tem noindex | A versão não é indexada, então a tag não tem efeito | Remova o noindex ou tire esse endereço da lista |
| O canonical aponta para outra versão de idioma | O Google encontra sinais contraditórios | Cada versão deve ter seu próprio canonical |
Código incorreto (como en-uk) | A tag é considerada inválida | Verifique os códigos ISO |
| Implementação apenas na página inicial | As páginas internas ficam confusas | Cada página deve apontar para o seu próprio equivalente |
Outra situação comum: quando não há correspondência exata entre as versões (existe a página em inglês, mas não a em alemão), não adicione a linha de alemão para essa página. O hreflang funciona apenas com os equivalentes que realmente existem.
Validação e teste
- Verificação do código-fonte: Clique com o botão direito na página, escolha ver o código-fonte e procure por
hreflang. Se a tag for inserida com JavaScript, use a ferramenta Inspeção de URL do Search Console para ver o HTML que o Google está vendo. - Ferramenta de rastreamento: Um rastreador de desktop mostra as colunas hreflang em uma única tabela e identifica em lote as tags de retorno ausentes e os códigos inválidos.
- Sitemap: Se você usa o método do sitemap, confirme que cada registro
urlcontém todas as correspondências de idioma. - Buscas reais: Em um dispositivo do país-alvo ou com a configuração de idioma de busca correspondente, veja se a versão certa aparece nos resultados.
Para revisar o hreflang junto com os demais pontos técnicos, você pode usar nossa lista de verificação de SEO técnico. Para a documentação oficial do Google, consulte o artigo sobre versões localizadas de sites multilíngues e multirregionais.
Perguntas frequentes
O hreflang melhora o posicionamento?
Não. Ele não afeta diretamente o posicionamento; apenas ajuda a mostrar ao usuário a versão de idioma ou região correta.
Em um site de um só idioma, o hreflang é necessário?
Não. Você só precisa dele em sites que oferecem conteúdo em mais de um idioma ou em mais de uma região.
O hreflang e o canonical podem ser usados juntos?
Sim, e devem ser usados juntos. Cada versão aponta o canonical para o próprio endereço, e o hreflang conecta as versões entre si.
Adicionei a tag, mas o resultado não mudou logo. Por quê?
O Google precisa rastrear novamente todas as versões. Para ver o efeito, podem ser necessários dias; em sites grandes, semanas.
Conclusão
O hreflang é um processo pequeno, mas exige atenção, para que a página certa chegue ao usuário certo em um site multilíngue. As regras de ouro são curtas: cada versão deve listar todas as versões, incluindo a si mesma; os códigos devem ser padrão; os endereços devem retornar 200; e não pode haver conflito com o canonical. Depois da implementação, basta verificar uma vez com uma ferramenta de rastreamento e revisar novamente a cada grande alteração. Se você pensa em produzir conteúdo multilíngue, faça antes uma pesquisa de palavras-chave e avalie separadamente o hábito de busca de cada idioma; a tradução palavra por palavra quase nunca é suficiente.