Hreflang para páginas internacionais
Indique variantes de idioma e região aos mecanismos de busca.
Hreflang para páginas internacionais é uma aula grátis de HTML Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de HTML Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de HTML Academy inclui 4 aulas no total.
O problema que hreflang resolve
Quando você publica o mesmo artigo em inglês, turco e japonês, os mecanismos de pesquisa precisam saber qual versão exibir nos resultados de pesquisa de cada usuário. Sem hreflang, o Google pode exibir o idioma errado ou tratar as variantes como conteúdo duplicado.
O elemento link
Declare cada versão alternativa com <link rel="alternate" hreflang="..." href="..."> no <head>. O atributo hreflang é um código de idioma BCP-47 (en, tr) ou um par idioma-região (en-US, en-GB, pt-BR).
<link rel="alternate" hreflang="en" href="https://example.com/en/article">
<link rel="alternate" hreflang="tr" href="https://example.com/tr/article">
<link rel="alternate" hreflang="ja" href="https://example.com/ja/article">Referências recíprocas obrigatórias
Cada versão deve apontar para todas as outras versões, incluindo para si mesma. O Google ignora conjuntos de hreflang que não sejam bidirecionais. A página em inglês aponta para TR e JA; a página em turco aponta para EN e JA; e assim por diante.
Referência a si mesma
Cada página deve apontar para si mesma por meio de hreflang. A página em inglês deve incluir <link rel="alternate" hreflang="en" ...> apontando para seu próprio URL. Isso faz parte da referência "recíproca" — o Google usa esse apontamento para confirmar a participação no conjunto.
O valor x-default
Use hreflang="x-default" para especificar a página alternativa para usuários cujo idioma o Google não consiga corresponder. Geralmente, ela aponta para a versão em inglês ou para uma página inicial de seleção de idioma, para que os usuários não direcionados ainda cheguem a um destino adequado.
Códigos de idioma versus códigos de região
en direciona para todos os falantes de inglês. en-US, en-GB e en-AU direcionam para variantes por país quando o conteúdo varia conforme a região (moeda, ortografia, entrega). Não especifique uma região a menos que o conteúdo realmente seja diferente da versão genérica.
Declarações alternativas
O hreflang também pode ser declarado no cabeçalho HTTP Link (para arquivos que não sejam HTML, como PDFs) ou em um mapa do site XML com <xhtml:link rel="alternate" hreflang="...">. Os três métodos são equivalentes; escolha o que for mais fácil de manter.
Declaração no mapa do site
Declarar hreflang em um mapa do site é mais escalável do que usar tags HTML em sites com muitos idiomas: uma entrada do mapa do site por URL lista todas as alternativas, eliminando a duplicação nos modelos de cada página. O Search Console sinaliza referências recíprocas ausentes para que os erros sejam identificados cedo.
Erros comuns
Usar um sublinhado (en_US) em vez de um hífen (en-US), apontar para uma URL que não retorna 200, misturar http e https no conjunto ou esquecer a referência a si mesma interrompe o hreflang silenciosamente. Execute o relatório de segmentação internacional do Google Search Console após o lançamento.
Não substitui a tradução
O hreflang apenas informa ao Google qual tradução já existe. As próprias páginas ainda precisam de conteúdo realmente traduzido — o Google não traduzirá em seu lugar. Sites que implementam hreflang em páginas que estão 80% em inglês confundem silenciosamente o índice.
Combinação com og:locale e lang
Defina <html lang="..."> e og:locale do documento para corresponder ao idioma real da página. O hreflang informa aos mecanismos de pesquisa sobre as páginas relacionadas; lang/og:locale informam aos navegadores e às redes sociais sobre a página atual. Ambos são necessários para uma visão completa.
Verificação de conhecimento
Para onde aponta hreflang="x-default"?
Resumo
O hreflang conecta versões traduzidas de uma página para que os mecanismos de pesquisa exibam o idioma correto. Use códigos BCP-47, declare as alternativas de forma recíproca (incluindo uma referência a si mesma), adicione x-default para a página alternativa e verifique no relatório de segmentação internacional do Google Search Console. A qualidade da tradução e as tags lang/og:locale também precisam corresponder.
Perguntas Frequentes
A aula “Hreflang para páginas internacionais” é grátis?
Sim — o texto completo de “Hreflang para páginas internacionais” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de HTML Academy, atualize para CoddyKit PRO. O curso de HTML Academy inclui 4 aulas no total.
O que vou aprender em “Hreflang para páginas internacionais”?
Indique variantes de idioma e região aos mecanismos de busca. Você pratica HTML Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar HTML Academy?
Nenhuma experiência prévia é necessária. HTML Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Hreflang para páginas internacionais”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de HTML Academy?
Sim. Cada aula de HTML Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- OpenGraph og:title og:description og:image
- Meta tags de cartão do Twitter
- Fundamentos de dados estruturados JSON-LD
- Hreflang para páginas internacionais