O que é hreflang x-default e quando você precisa dele?
hreflang="x-default" indica a página que o Google deve mostrar quando o idioma e a região do navegador do usuário não correspondem a nenhuma das versões que você lista, geralmente um seletor de idioma ou a sua versão principal. O Google o recomenda como página padrão, mas não o exige. Adicione-o quando receber visitantes de idiomas ou regiões que você não atende, e só dentro de um conjunto hreflang completo, em que cada página lista a si mesma e todas as outras.
Se uma auditoria apontou “missing x-default” ou “hreflang sem x-default”, a correção é uma linha por página. Essa linha só ajuda se o resto do conjunto estiver correto, e é aí que está a maioria dos problemas de hreflang. Este guia segue a documentação do Google sobre versões localizadas de uma página: o que x-default significa, as três formas de declará-lo e os erros que fazem o Google ignorar as anotações.
Neste artigo
- O que significa hreflang x-default?
- Como adiciono hreflang x-default no HTML?
- Posso declarar x-default em um cabeçalho HTTP?
- Como adiciono x-default a um sitemap XML?
- O que significa “missing x-default”, e quais erros de hreflang importam mais?
- Outros buscadores e motores de resposta com IA usam hreflang?
- Como a AISeeWhy verifica o hreflang?
O que significa hreflang x-default?
As anotações hreflang dizem ao Google qual URL atende a qual idioma ou região, para que ele mande cada usuário para a versão certa. O Google descreve x-default como um valor reservado usado quando nenhum outro idioma ou região corresponde à configuração do navegador do usuário. Ele foi pensado para páginas de seleção de idioma, e o Google o recomenda para indicar a página padrão.
Pense em um site com versões para en-GB, en-US e de. Um leitor na Alemanha recebe a página em alemão, e um leitor nos Estados Unidos recebe a página dos EUA. Um leitor com o navegador em francês não corresponde a nada, então o Google usa a página que você marcou como x-default.
O hreflang não diz ao Google em que idioma uma página está. O Google diz que não usa nem hreflang nem o atributo HTML lang para detectar o idioma de uma página. O hreflang só liga versões do mesmo conteúdo aos seus públicos.
- Você precisa de x-default quando chegam pessoas de idiomas ou regiões que você não atende e você tem um lugar sensato para mandá-las: um seletor de idioma ou uma versão global no seu idioma principal.
- Ele é especialmente útil quando a URL raiz detecta o idioma do visitante e redireciona ou mostra um seletor. Essa URL raiz é um x-default natural.
- Você não precisa dele, nem de hreflang nenhum, se a página só existe em um idioma.
Como adiciono hreflang x-default no HTML?
O método mais comum é um conjunto de elementos link no <head>. Todas as páginas do conjunto têm o mesmo bloco: uma linha por versão, incluindo uma linha para a própria página, mais a linha de x-default.
<!-- Put the same block in the <head> of every page in the set -->
<link rel="alternate" hreflang="en-GB" href="https://example.com/en-gb/pricing/" />
<link rel="alternate" hreflang="en-US" href="https://example.com/en-us/pricing/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" /> O Google exige URLs completas, incluindo https://. Um caminho relativo como /de/preise/ ou uma URL relativa ao protocolo como //example.com/de/preise/ não é válido. As URLs alternativas não precisam estar no mesmo domínio, então o padrão também funciona para sites com um domínio por país.
Posso declarar x-default em um cabeçalho HTTP?
Sim. O Google aceita um cabeçalho de resposta Link com os mesmos valores e diz que isso é útil para arquivos sem <head>, como PDFs. Cada versão lista todas as alternativas, incluindo ela mesma:
Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en", <https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de", <https://example.com/guide.pdf>; rel="alternate"; hreflang="x-default" Configure o cabeçalho no seu servidor web ou CDN para cada arquivo do conjunto. O Google diz que os três métodos são equivalentes do ponto de vista dele, então um cabeçalho não é mais forte nem mais fraco do que as tags HTML.
Como adiciono x-default a um sitemap XML?
Em sites grandes, colocar o hreflang no sitemap o tira de todos os templates de página. Cada entrada <url> lista todas as versões com elementos xhtml:link, incluindo ela mesma, e o urlset precisa declarar o namespace xhtml. A página x-default recebe uma entrada própria com o mesmo conjunto:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>https://example.com/en/pricing/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing/"/>
<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/pricing/"/>
</url>
<url>
<loc>https://example.com/de/preise/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing/"/>
<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/pricing/"/>
</url>
<url>
<loc>https://example.com/pricing/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing/"/>
<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/pricing/"/>
</url>
</urlset> Escolha um método e mantenha a consistência. O Google diz que combinar métodos não traz benefício na Pesquisa, e duas fontes que divergem são mais difíceis de manter do que uma.
O que significa “missing x-default”, e quais erros de hreflang importam mais?
Um aviso “missing x-default” significa que a página lista alternativas de idioma, mas nenhuma usa x-default. O conjunto continua funcionando para os idiomas listados, porque o Google recomenda o x-default em vez de exigi-lo. Os erros abaixo são mais graves, porque podem fazer o Google ignorar as anotações ou interpretá-las errado:
- Links de retorno ausentes. Se a página A lista a página B, a página B precisa listar a página A. O Google diz que anotações que não apontam uma para a outra podem ser ignoradas.
- Sem autorreferência. Cada versão precisa listar a si mesma, além de todas as outras versões.
- Região sem idioma.
hreflang="GB"é inválido; não dá para usar um código de país sozinho. Useen-GB. - Códigos inválidos. Idiomas usam códigos ISO 639-1, regiões usam códigos ISO 3166-1 Alfa 2 e sistemas de escrita usam ISO 15924, como em
zh-Hant. O Google observa queUK,EUeUNnão têm efeito no hreflang. UseGBpara o Reino Unido. Os códigos não diferenciam maiúsculas de minúsculas, entãoen-gbeen-GBsão iguais. - URLs relativas ou parciais em vez de completas.
- Um x-default que aparece em algumas páginas do conjunto e em outras não. Como cada página lista o conjunto completo, a linha de x-default deve estar em todas as páginas.
Outros buscadores e motores de resposta com IA usam hreflang?
As regras deste guia são do Google. A página do Google não fala por outros buscadores, então confira a documentação para webmasters de cada um se você depende dele.
Para motores de resposta com IA, não há documentação em que se basear. A documentação de crawlers publicada pela OpenAI, pela Anthropic e pela Perplexity que analisamos não menciona hreflang, então nada diz se ChatGPT, Claude ou Perplexity o usam para escolher a versão de idioma que citam. Trate como não comprovada qualquer afirmação de que o x-default muda respostas de IA.
O que você controla é o acesso. Cada versão de idioma é uma URL comum que os crawlers de IA buscam como qualquer outra, então garanta que o robots.txt e o seu firewall deixem que eles cheguem a todas as versões que você quer ver citadas.
Como a AISeeWhy verifica o hreflang?
A AISeeWhy aponta um conjunto de idiomas que tem alternativas hreflang mas não tem x-default, e o guia de correção de “hreflang sem x-default” mostra a linha a adicionar. A verificação gratuita também mostra se os crawlers de IA conseguem chegar à página, o que importa para cada versão de idioma.
Correções para este problema
Próximos passos
- Testador e verificador de robots.txt para crawlers de IA
- Veja um exemplo de relatório completo
- Monitoramento de crawlers de IA
- Planos e preços
Perguntas frequentes
O hreflang x-default é obrigatório?
Não. O Google recomenda x-default para indicar a página padrão, mas um conjunto sem ele continua funcionando para os idiomas e regiões que lista. Adicione-o quando receber visitantes cujo idioma você não atende.
Para qual página o x-default deve apontar?
O Google o pensou para páginas de seleção de idioma. Se você não tem uma, use a versão que quer mostrar a visitantes sem correspondência, geralmente o seu idioma principal. Qualquer que seja a URL escolhida, dê a ela o mesmo bloco de anotações das outras páginas do conjunto.
hreflang="en-UK" é válido?
Não. UK não é o código ISO 3166-1 do Reino Unido, e o Google diz que ele não tem efeito no hreflang. Use en-GB.
Devo usar tags HTML e sitemap ao mesmo tempo?
Não é preciso. O Google trata os métodos de HTML, cabeçalho HTTP e sitemap como equivalentes e diz que combiná-los não traz benefício na Pesquisa. Escolha o que for mais fácil de manter correto.
O hreflang diz ao Google em que idioma está minha página?
Não. O Google diz que não usa hreflang nem o atributo HTML lang para detectar o idioma. O hreflang liga versões do mesmo conteúdo aos públicos que elas atendem.
Fontes
- Google Search Central: Tell Google about localized versions of your page
- OpenAI: Overview of OpenAI crawlers
- Anthropic: Does Anthropic crawl data from the web, and how can site owners block the crawler?
- Perplexity: Perplexity crawlers