URL canônica: o que é e como configurar

O que é uma URL canônica

Uma URL canônica (ou rel canonical) é uma tag HTML que diz ao buscador: entre todas as versões desta página, esta é a principal. Ela resolve um dos problemas de SEO mais comuns: a duplicação de conteúdo, quando o mesmo material está acessível em vários endereços.

Sem o canonical, o buscador decide sozinho qual versão tratar como principal — e muitas vezes escolhe justamente a que você não quer no índice. A tag dá controle: você declara a URL preferida, e o Google e o Yandex seguem essa indicação na maioria dos casos.

zoom_in

Canonical em números

Canonical: significado e conceito central

A palavra “canonical” chegou à web a partir da matemática e da lógica: forma canônica é a representação mais simples e padrão de um objeto. No contexto de URLs, o endereço canônico é o link “oficial” que o buscador usa para ranqueamento e indexação, enquanto todas as outras versões são tratadas como duplicatas.

Canonical e redirecionamento 301 costumam ser confundidos. A diferença principal: o redirecionamento é uma diretiva; o canonical é uma dica. O redirecionamento leva o usuário fisicamente para uma nova URL. O canonical mantém o usuário na página original, mas indica ao buscador qual URL deve ser considerada principal para a indexação.

Como adicionar a tag canonical

A tag canonical vai na seção <head> da página duplicada. A sintaxe não mudou desde 2009: é um único elemento <link> sem conteúdo. O atributo href precisa conter uma URL absoluta completa:

<head>
  <meta charset="UTF-8">
  <title>Laptops — buy at TechShop</title>
  <link rel="canonical" href="https://example.com/catalog/laptops/">
</head>

Se a página for um PDF, uma imagem ou outro arquivo sem <head> HTML, o canonical pode ser enviado pelo cabeçalho HTTP Link. A configuração do nginx abaixo funciona tanto para recursos que não são HTML quanto para páginas comuns, quando você controla o servidor diretamente:

# nginx.conf — canonical via HTTP header
# For PDF and other non-HTML resources:
location ~* \.pdf$ {
    add_header Link '<https://example.com/docs/price-list.pdf>; rel="canonical"';
}

# For dynamic URLs with GET parameters:
location /catalog/ {
    add_header Link '<https://example.com/catalog/>; rel="canonical"';
}

As cinco regras de canonical que mais costumam ser violadas:

• Apenas URLs absolutas. Sempre escreva o endereço completo: https://example.com/page/, não /page/. Canonicals relativos são tecnicamente suportados, mas se comportam mal quando o domínio ou o protocolo muda.
• Canonical em https. O canonical precisa apontar para a versão https da página. Se o site usa HTTPS, mas o canonical referencia http://, cria-se uma duplicata que o buscador não consegue resolver corretamente.
• Um canonical por página. Várias tags <link rel="canonical"> com valores href diferentes: o buscador ignora todas ou escolhe uma arbitrariamente.
• O canonical precisa ser acessível. Uma tag apontando para uma URL com 404 ou 301 não faz sentido. A página principal precisa retornar 200 OK.
• Barra final consistente. Se a URL principal é /catalog/ (com barra), o canonical também deve ter a barra. Misturar variantes cria novas duplicatas.

Quando usar canonical

O canonical resolve seis cenários clássicos de duplicação de conteúdo. Veja cada um com exemplos reais de URL.

Canonical em CMS: WordPress, Bitrix e Tilda

As plataformas de CMS mais populares geram canonicals automaticamente ou oferecem uma ferramenta integrada. A configuração manual só é necessária em cenários não padrão ou quando o CMS não trata esses casos corretamente.

WordPress

Os plugins Yoast SEO e Rank Math adicionam automaticamente um <link rel="canonical"> autorreferente em cada página e post. Se você não usa esses plugins, adicione o seguinte ao functions.php do seu tema:

<?php
// functions.php — canonical without an SEO plugin
add_action('wp_head', function() {
    if (is_singular()) {
        echo '<link rel="canonical" href="' . esc_url(get_permalink()) . '">' . "\n";
    } elseif (is_home() || is_front_page()) {
        echo '<link rel="canonical" href="' . esc_url(home_url('/')) . '">' . "\n";
    }
}, 1);

Bitrix

No 1C-Bitrix, o canonical é definido nas propriedades da página. A abordagem padrão é atribuir o valor em um componente e exibi-lo no header.php do template principal:

<?php
// In a component or init.php: set the canonical
$canonicalUrl = 'https://' . SITE_SERVER_NAME . $APPLICATION->GetCurPage(false);
$APPLICATION->SetPageProperty('canonical', $canonicalUrl);

// In the template's header.php: output the tag
$canonical = $APPLICATION->GetPageProperty('canonical');
if ($canonical):
?><link rel="canonical" href="<?= htmlspecialchars($canonical, ENT_QUOTES, 'UTF-8') ?>">
<?php endif; ?>

Tilda

Erros e verificação pelo Google Search Console

O Google Search Console é a principal ferramenta para acompanhar o status do canonical. No relatório Indexação → Páginas, você verá alguns status ligados ao canonical:

Além do GSC, verifique o canonical no nível da resposta HTTP. O jeito mais rápido, sem ferramentas, é o código-fonte do navegador (Ctrl+U → pesquise por canonical) ou o curl:

# Check canonical in HTTP header:
curl -sI https://example.com/catalog/?sort=price | grep -i link

# Check canonical in HTML (first 2000 bytes of response):
curl -s https://example.com/page/ | head -c 2000 | grep -i canonical

• Cadeias de canonical. Página A → canonical B → canonical C. Os buscadores preferem apontamentos diretos. Garanta que o canonical leve direto à URL principal final, sem paradas intermediárias.
• Canonical apontando para um redirecionamento. Um canonical que aponta para uma URL 301 envia um sinal ambíguo. O buscador precisa seguir a cadeia; é mais limpo apontar direto para a URL final.
• Noindex + canonical: contradição. Uma página com noindex e canonical envia sinais conflitantes. Use um ou outro: ou aplique noindex na página, ou defina o canonical para a URL principal.
• Canonical via JavaScript. O Google consegue processar tags canonical inseridas por JS, mas o processo é mais lento e menos confiável. Prefira sempre um <link> estático no <head> do HTML.

FAQ

Respostas às dúvidas mais frequentes sobre canonical que surgem em auditorias de SEO.

Resumo

zoom_in

A tag canonical é uma das ferramentas fundamentais do SEO técnico. É simples de implementar, mas causa problemas sérios de indexação com frequência quando está mal configurada ou ausente em sites com geração dinâmica de URLs. Três regras básicas — URL absoluta, canonical em https e nenhuma cadeia — resolvem 80% dos erros possíveis.

Comece verificando o estado atual: GSC → relatório de Páginas → filtre pelos status “Duplicadas” e “Não indexadas”. Isso mostra rapidamente onde o canonical está faltando ou sendo ignorado pelo buscador.