Você ativa os breadcrumbs no Yoast, abre uma página e encontra duas trilhas de navegação empilhadas. Ou pior: o tema não tem hook nenhum, e a trilha simplesmente não aparece, mesmo com a opção ligada. Configurar breadcrumbs no WordPress sem duplicar exige uma ordem de decisão que quase nenhum tutorial mostra: primeiro checar o que o tema já imprime, depois escolher a origem da trilha, e só então validar o schema.
Por que breadcrumbs duplicados aparecem ao ativar o Yoast
O Yoast SEO tem uma opção para habilitar breadcrumbs. Quando você liga, ele passa a gerar o HTML da trilha e o schema BreadcrumbList. O problema é que muitos temas já fazem isso por conta própria. O tema imprime a trilha no template, o Yoast imprime a dele, e o resultado são duas navegações iguais na mesma página.
Além disso, o Google pode ler dois conjuntos de dados estruturados BreadcrumbList na mesma URL. Isso não quebra o site, mas confunde a leitura e pode fazer o rich result ser ignorado. Por isso, a primeira pergunta não é “como ativar”, e sim “quem já está imprimindo”.
Ordem de decisão para não duplicar a trilha de navegação WordPress
Antes de mexer em qualquer plugin, siga esta sequência. Ela evita retrabalho e o erro clássico de ativar o Yoast sem checar o tema.
- Inspecione o HTML da página. Abra uma página interna do site, clique com o botão direito e escolha “Inspecionar”. Procure por
breadcrumbouBreadcrumbListno código. Se já existir uma trilha, o tema está imprimindo. - Veja se o tema tem suporte declarado. Em Aparência > Personalizar, procure uma seção de breadcrumbs. Muitos temas exibem essa opção quando dão suporte nativo.
- Decida a origem. Se o tema já imprime, mantenha a dele e não ative a do Yoast. Se o tema não imprime, use o Yoast.
- Valide o schema. Só depois de decidir a origem, teste no Rich Results Test do Google.
Essa ordem importa porque desfazer uma duplicação depois é mais trabalhoso do que evitar. Se você já ativou o Yoast e o tema também imprime, desative um dos dois. Na prática, desligar a opção do Yoast é mais simples do que editar o template do tema.
Como saber se o tema já imprime breadcrumbs
Nem todo tema deixa claro se tem suporte. Alguns imprimem a trilha por padrão, sem opção no personalizador. Outros só mostram se você chamar uma função no template.
Para checar sem quebrar nada, use o inspetor de elementos. Se encontrar uma nav com classe breadcrumb ou um script do tipo application/ld+json com BreadcrumbList, o tema está ativo. Se não encontrar nada, o tema provavelmente não imprime.
Outra forma é olhar a documentação do tema. Temas populares costumam listar se suportam breadcrumbs e como ativar. Se o tema for premium, verifique o changelog ou o manual do desenvolvedor.
Configurar breadcrumbs no Yoast SEO
Com a decisão tomada, a configuração no Yoast é direta. Vá em SEO > Configurações > Avançado > Breadcrumbs e ative a opção. Depois, escolha o separador e defina o texto para a página inicial.
O Yoast gera a trilha automaticamente para posts, páginas, categorias e produtos. Para exibir no tema, você precisa inserir o shortcode ou a função no local desejado. O shortcode é Início » . A função é yoast_breadcrumb().
Se o tema tiver um hook, como before_content ou after_header, você pode adicionar a função via functions.php do tema filho. Se não tiver hook, será preciso editar o template diretamente. Nesse caso, use um tema filho para não perder a alteração em atualizações.
Quando o tema não tem hook nenhum
Esse é o cenário em que a receita de “só ligar no Yoast” falha silenciosamente. A opção fica ativa, mas a trilha não aparece porque ninguém chama a função. A solução é editar o arquivo de template (geralmente single.php ou page.php) e inserir a chamada.
Antes de editar, crie um tema filho. Se você editar o tema pai, qualquer atualização apaga a alteração. No arquivo, adicione:
<?php if ( function_exists( 'yoast_breadcrumb' ) ) { yoast_breadcrumb( '<p id="breadcrumbs">', '</p>' ); } ?>A verificação function_exists evita erro fatal se o Yoast for desativado. Depois de salvar, limpe o cache do site e verifique a página.
Shortcode do Yoast ou do tema: qual usar
Se o tema tem shortcode próprio para breadcrumbs, você pode usar o dele. A vantagem é que o estilo já vem integrado ao design. A desvantagem é que o schema pode não ser gerado, ou ser gerado de forma diferente.
O Yoast gera o schema BreadcrumbList automaticamente quando a opção está ativa. Isso ajuda o Google a entender a hierarquia. Por isso, se o tema não gera schema, usar o Yoast é mais vantajoso para SEO.
| Origem | Vantagem | Desvantagem |
|---|---|---|
| Yoast | Gera schema BreadcrumbList e integra com o restante do plugin | Pode duplicar se o tema já imprime |
| Tema | Estilo já integrado ao design | Pode não gerar schema ou gerar de forma incompleta |
Se você já usa o Yoast para outras funções de SEO, centralizar os breadcrumbs nele simplifica a manutenção. Mas se o tema já entrega uma trilha bonita e com schema, não há motivo para trocar.
Validar o schema BreadcrumbList no Rich Results Test
Depois de configurar, valide. O Google oferece o Rich Results Test, que mostra se o schema BreadcrumbList está sendo lido corretamente. Acesse a ferramenta, cole a URL da página e execute o teste.
O resultado esperado é que apareça “Breadcrumbs” como item válido. Se aparecer erro, verifique se há dois schemas conflitantes. Nesse caso, remova um deles. Se aparecer aviso de que o item não é elegível, pode ser que a trilha não esteja no formato esperado.
Além do Rich Results Test, use a aba de cobertura do Search Console para ver se as páginas estão indexadas. Se o schema estiver correto, os breadcrumbs podem aparecer nos resultados de busca. Para um checklist mais amplo, veja o checklist de SEO técnico para auditar sites WordPress.
Erros comuns ao configurar breadcrumbs no WordPress
- Ativar o Yoast sem checar o tema. É a causa mais comum de duplicação. Sempre inspecione o HTML antes.
- Editar o tema pai. A alteração some na próxima atualização. Use tema filho.
- Esquecer de limpar o cache. Muitos plugins de cache e CDNs mantêm a versão antiga da página. Limpe tudo antes de validar.
- Não validar o schema. Sem validação, você não sabe se o Google está lendo a trilha.
- Usar shortcode em local errado. Se o shortcode for inserido dentro de um loop, pode repetir a trilha várias vezes.
Se o Yoast apresentar comportamento estranho, como a trilha sumir ou o painel travar, pode ser um conflito com outro plugin. Nesse caso, veja como diagnosticar e corrigir o Yoast SEO quebrado no WordPress.
Quando NÃO usar breadcrumbs do Yoast
Se o tema já imprime a trilha e gera o schema BreadcrumbList corretamente, não ative a opção do Yoast. Você só criaria duplicação. Nesse caso, mantenha o que o tema oferece e foque em outros ajustes de SEO.
Outro caso: se o site é uma landing page única, sem hierarquia de categorias, breadcrumbs podem não fazer sentido. A trilha ajuda quando há uma estrutura de navegação clara. Em páginas isoladas, ela pode até confundir o visitante.
Por fim, se você usa um construtor como Elementor e o tema é baseado nele, verifique se o próprio construtor já oferece um widget de breadcrumbs. Usar o widget pode ser mais simples do que inserir shortcode.
Prevenção ao replicar a configuração em vários sites
Quem administra vários sites precisa repetir essa checagem em cada um. Temas diferentes, plugins diferentes, resultados diferentes. O que funcionou em um site pode duplicar em outro.
Uma boa prática é documentar, para cada site, qual é a origem da trilha. Assim, ao migrar ou atualizar, você sabe onde mexer. Se o site usar um tema que já imprime breadcrumbs, anote que o Yoast deve ficar desligado nessa parte.
Além disso, mantenha um olhar sobre o schema. Após atualizações de tema ou do Yoast, valide novamente uma página de cada tipo (post, página, produto). Mudanças de versão podem alterar a saída do schema. Para entender como o SEO incidental pode ser corrigido sem planejamento, veja SEO incidental no WordPress: o que corrigir sem planejar.
Se você gerencia muitos sites, o 100% WP ajuda a acompanhar atualizações e backups em um só painel, o que reduz o risco de uma atualização de tema quebrar a trilha sem você perceber.
Quando chamar um desenvolvedor
Se o tema não tem hook e você não se sente confortável em editar arquivos PHP, chame um desenvolvedor. Editar o template errado pode derrubar o site. O mesmo vale se você encontrar dois schemas conflitantes e não souber qual remover.
Para projetos maiores, com muitos sites e necessidade de padronização, um serviço de SEO técnico pode ajudar a definir a melhor abordagem. Mas se o problema é só a duplicação, a solução costuma ser simples: desligar uma das origens.
Em resumo, configurar breadcrumbs no WordPress sem duplicar é uma questão de ordem: inspecionar, decidir, configurar e validar. Pular a primeira etapa é o que gera a dor de cabeça.
Fonte: Google Search Central
