Ir para o conteúdo principal
Bethemesh
Web e SEO

Gerador e validador hreflang

Transforme uma lista idioma=URL em etiquetas link hreflang e detete entradas inválidas ou duplicadas.

  • Área de transferência

Integrar este widget

Personalize o resultado, verifique a pré-visualização e copie o código.

Pré-visualização

Tipo de código de integração

Código a copiar

Responsivo e redimensionado automaticamente pela Bethemesh.

Etiquetas hreflang

Esta ferramenta foi útil?

Como funciona esta ferramenta?

Este gerador transforma uma lista de versões linguísticas de uma página em etiquetas <link rel="alternate" hreflang> prontas a colar no <head>. Verifica também o formato dos códigos de idioma, os duplicados e a validade dos URL, para evitar os erros que impedem os motores de pesquisa de associar as traduções de uma mesma página.

Cada linha segue o formato código=URL. O código aceita um idioma de 2 ou 3 letras (pt, en, ast), opcionalmente seguido de uma região de 2 letras (pt-PT, pt-BR), ou o valor especial x-default.

O URL tem de ser absoluto e começar por http ou https. O navegador normaliza-o antes de o escrever na etiqueta.

Um código já usado, mesmo com maiúsculas diferentes (pt e PT), é recusado: duas versões não podem reivindicar o mesmo idioma. As linhas recusadas não aparecem no resultado e o estado pede para as corrigir.

O resultado lista uma etiqueta por versão, pela ordem introduzida. Esse mesmo bloco tem de estar em todas as páginas da lista, incluindo a própria página.

Como usar esta ferramenta

  1. Liste as versões

    Introduza uma linha por versão no formato pt=https://example.com/pt/pagina.

  2. Acrescente x-default se necessário

    Indique a página a mostrar quando nenhum idioma corresponde, muitas vezes um seletor de idioma ou a versão inglesa.

  3. Verifique o estado

    Configuração válida ou mensagem de erro: corrija as linhas assinaladas.

  4. Copie as etiquetas

    Cole o bloco no <head> de cada versão da lista.

Casos de uso

Lançar uma versão traduzida

Declarar o novo idioma em todas as versões existentes de uma página sem escrever as etiquetas à mão.

Visar países com o mesmo idioma

Separar pt-PT e pt-BR quando os preços, os envios, o vocabulário ou as menções legais mudam.

Verificar uma lista antes de publicar

Detetar um código mal formado ou um URL relativo antes de os levar para um template.

Exemplos

Página de preços em três idiomas e uma versão suíça

São geradas quatro etiquetas; a versão inglesa serve também de página predefinida.

Entrada

Versões localizadas:
fr=https://example.com/fr/tarifs
en=https://example.com/en/pricing
de-CH=https://example.com/ch/preise
x-default=https://example.com/en/pricing

Resultado

Configuração válida
<link rel="alternate" hreflang="fr" href="https://example.com/fr/tarifs" />
<link rel="alternate" hreflang="en" href="https://example.com/en/pricing" />
<link rel="alternate" hreflang="de-CH" href="https://example.com/ch/preise" />
<link rel="alternate" hreflang="x-default" href="https://example.com/en/pricing" />

Código de idioma duplicado

FR é recusado porque fr já existe: só a primeira linha gera uma etiqueta.

Entrada

Versões localizadas:
fr=https://example.com/fr/
FR=https://example.com/fr-bis/

Resultado

Corrija as linhas inválidas ou os códigos de idioma duplicados.
<link rel="alternate" hreflang="fr" href="https://example.com/fr/" />

Dicas e boas práticas

  • Cada versão tem de apontar para todas as outras e para si própria: uma anotação sem ligação de retorno é ignorada pelo Google.
  • Use códigos ISO 639-1 para o idioma e ISO 3166-1 para a região: en-GB e não en-UK. A ferramenta verifica o formato, não se o código existe.
  • Os URL da lista devem ser canónicos, indexáveis e responder com o código 200; evite redirecionamentos.
  • Num site grande, as mesmas anotações podem ser declaradas no sitemap XML ou num cabeçalho HTTP Link, por exemplo para ficheiros PDF.

Fontes e referências

Perguntas frequentes

Para que serve o atributo hreflang?

Indica aos motores de pesquisa que uma página existe noutros idiomas ou para outros países, para que mostrem a cada utilizador a versão certa. Não melhora o posicionamento: evita mostrar a versão errada.

O que significa x-default?

É a página proposta quando o idioma ou o país do utilizador não corresponde a nenhuma versão da lista, por exemplo uma página de escolha de idioma ou a versão internacional.

É preciso indicar o país além do idioma?

Só se o conteúdo mudar de país para país (moeda, envios, vocabulário), como entre Portugal e o Brasil. Um código só de idioma, como pt, cobre todos os lusófonos. Um código só de país, como BR, não é válido.

Porque é que uma linha é recusada?

Falta o separador =, o código não segue o formato idioma ou idioma-região, o código já está em uso ou o URL não é um endereço absoluto http ou https.

A ferramenta verifica as ligações de retorno entre páginas?

Não. Gera o bloco a colocar em cada versão, mas não descarrega as páginas. Confirme no site publicado que cada versão contém o mesmo bloco.

Os meus URL são enviados para um servidor?

Não. As etiquetas são geradas no seu navegador.

Ferramentas relacionadas

Continue com estas ferramentas

Ferramentas semelhantes ou complementares a esta.

Ferramentas semelhantes

Gerador de meta tags

Crie as meta tags SEO, Open Graph e Twitter/X de uma página Web.

Web e SEOEm destaqueUtilizar esta ferramenta

Gerador de robots.txt

Crie um ficheiro robots.txt claro para orientar os robots de rastreio.

Web e SEOEm destaqueUtilizar esta ferramenta

Leia também

TutorialBoas práticasIniciante

Otimizar imagens para a Web sem perder qualidade

Redimensionamento, compressão, WebP, AVIF e boas práticas: um método completo para tornar as imagens de um site mais leves sem degradar desnecessariamente o resultado.

30 de agosto de 20264 min