Astra Rank Math breadcrumbs duplicados: correção

Tipo SEO Tecnico

Nome do erro Breadcrumbs duplicados entre Astra Pro e Rank Math EN: Duplicate breadcrumbs between Astra Pro and Rank Math

Severidade Atenção

Descrição Breadcrumbs duplicados entre Astra Pro e Rank Math aparecem quando o tema Astra renderiza a própria trilha de navegação e o Rank Math também emite a dele na mesma página. A correção e definir uma única fonte de breadcrumb, mantendo so o tema ou so o plugin renderizando a trilha.

O que é breadcrumbs duplicados entre Astra Pro e Rank Math?

Breadcrumbs duplicados entre Astra Pro e Rank Math são duas trilhas de navegação (por exemplo, Inicio / Categoria / Post) exibidas na mesma página, uma desenhada pelo tema Astra e outra pelo plugin Rank Math. O Astra tem um módulo de breadcrumb próprio, com uma Posicao definida no Personalizar, e o Rank Math expoe a função rank_math_the_breadcrumbs(), que muitos temas e templates chamam automaticamente. Quando as duas fontes ficam ativas e visiveis, a página mostra a trilha duas vezes.

O problema e de fonte concorrente, não de bug. Cada sistema acredita ser o responsável pela trilha e a renderiza no seu ponto do layout, entao o visitante ve duas linhas de navegação e o código-fonte traz dois blocos de breadcrumb. O Rank Math documenta que temas com suporte nativo já injetam a chamada da trilha, o que explica por que ela aparece sem você ter inserido a função manualmente.

Como identificar

Duas trilhas de navegação aparecem empilhadas no topo do post ou da página, geralmente uma logo acima do título e outra abaixo do cabeçalho
No código-fonte (Ctrl+U) ha dois blocos de breadcrumb, um com a marcacao do Astra e outro emitido pela função rank_math_the_breadcrumbs
O Teste de Resultados Aprimorados do Google detecta dois conjuntos de dados estruturados BreadcrumbList para a mesma URL
Ao mudar a Posicao do breadcrumb do Astra no Personalizar, so uma das trilhas se move, confirmando que são duas fontes diferentes
A duplicidade aparece em todos os tipos de conteúdo (post, página, arquivo e produto), não so em um modelo isolado

Como prevenir

Defina desde o inicio uma única fonte de breadcrumb por site, ou o tema ou o plugin de SEO, e documente a escolha
Ao usar Astra com Rank Math, ajuste a opção Selecionar fonte do Astra para o Rank Math em vez de deixar como Padrão
Após trocar de tema ou ativar um novo template, confira o código-fonte e o teste do Google para garantir um único BreadcrumbList por URL
Evite inserir a função rank_math_the_breadcrumbs() manualmente no tema se o breadcrumb do Astra já estiver ligado no Personalizar

Causa

O módulo de breadcrumb do Astra esta com a Posicao definida como Antes do conteúdo ou Após o cabeçalho em Aparencia -> Personalizar -> Breadcrumb, e ao mesmo tempo o Rank Math emite a própria trilha.
A opção Selecionar fonte (Select Source) do breadcrumb do Astra esta como Padrão em vez de apontar para o Rank Math, fazendo o tema gerar a trilha por conta própria além da do plugin.
Um template do Astra Pro (cabeçalho ou layout customizado) inclui o widget ou a chamada de breadcrumb, somando uma trilha ao que o Rank Math já renderiza via rank_math_the_breadcrumbs.
O single.php ou um template do tema filho tem a chamada manual rank_math_the_breadcrumbs() inserida, e o breadcrumb do Astra continua ligado no Personalizar.
Um construtor como Elementor monta o cabeçalho com um widget de breadcrumb próprio, enquanto o breadcrumb nativo do Astra segue ativo na mesma página.

Como resolver

Confirme as duas fontes no código-fonte: Abra um post publicado, veja o código-fonte e localize os dois blocos de trilha para saber qual veio do Astra e qual veio do Rank Math antes de desligar qualquer um.
```
Abrir a página no navegador e pressionar Ctrl+U
Buscar (Ctrl+F) por breadcrumb
Buscar por rank-math-breadcrumb
Anotar qual bloco tem a marcacao do Astra e qual tem a do Rank Math
```
Decida qual fonte vai renderizar a trilha: Escolha uma única fonte para o breadcrumb. O caminho mais simples e manter o Rank Math como dono do dado estruturado e usar o Astra apenas para posicionar a trilha, ou desligar a trilha do Astra e deixar so o plugin.
Aponte a fonte do breadcrumb do Astra para o Rank Math: Se quiser manter a posicao do tema, diga ao Astra para usar a trilha do Rank Math em vez de gerar a própria; assim o tema renderiza uma única trilha, a do plugin, na posicao escolhida.
```
Aparencia -> Personalizar -> Breadcrumb
Abrir Selecionar fonte (Select Source)
Trocar de Padrão para Rank Math
Publicar as alterações do Personalizar
```
Ou desligue a trilha do Astra e deixe so o Rank Math: Se a posicao do plugin já esta correta, desligue o breadcrumb do tema definindo a Posicao do Astra como Nenhuma, eliminando a trilha duplicada do lado do tema.
```
Aparencia -> Personalizar -> Breadcrumb
Abrir o seletor Posicao (Position)
Selecionar Nenhuma (None)
Publicar as alterações do Personalizar
```

Remova chamadas manuais e revalide: Se ainda houver duplicidade, procure uma chamada manual da trilha no tema filho ou em um widget do construtor, remova a sobra, limpe o cache e confirme uma única trilha no código-fonte e no teste do Google.

Revisar single.php do tema filho e remover a chamada manual rank_math_the_breadcrumbs() se houver
Conferir se o cabeçalho do Elementor ou template do Astra Pro tem widget de breadcrumb e remover o excedente
Limpar o cache de página, de objeto e da CDN
Rodar o Teste de Resultados Aprimorados do Google na URL e confirmar um único BreadcrumbList

PHP

<?php
/**
 * Remove a trilha de breadcrumb nativa do Astra para deixar SO o Rank Math
 * renderizar a navegacao. Use quando preferir resolver por codigo em vez do
 * Personalizar (ex.: posicao do tema fixada por um template do Astra Pro).
 * Coloque em um plugin de snippets, nunca no functions.php do tema pai.
 */
add_action( 'wp', function () {
    // Desliga o ponto onde o Astra imprime a propria trilha.
    remove_action( 'astra_header_after', 'astra_breadcrumb' );
    remove_action( 'astra_entry_top', 'astra_breadcrumb' );
}, 20 );

Perguntas frequentes

Por que os breadcrumbs duplicados aparecem com Astra Pro e Rank Math juntos

Porque são duas fontes concorrentes. O Astra tem um módulo de breadcrumb próprio com posicao no Personalizar, e o Rank Math emite a trilha pela função rank_math_the_breadcrumbs, que temas com suporte nativo chamam sozinhos. Com as duas ativas, a trilha sai duas vezes na mesma página.

Devo desligar o breadcrumb do Astra ou o do Rank Math

Mantenha so um renderizando. O caminho mais limpo e deixar o Rank Math como dono do dado estruturado e apontar a fonte do breadcrumb do Astra para o Rank Math, ou definir a Posicao do Astra como Nenhuma e deixar so o plugin gerar a trilha.

Onde fica a opção para escolher a fonte do breadcrumb no Astra

Em Aparencia, Personalizar, Breadcrumb. Ali existem o seletor de Posicao e a opção Selecionar fonte (Select Source), onde você troca de Padrão para Rank Math. Trocar a fonte faz o tema renderizar a trilha do plugin em vez de gerar uma própria.

Apontar a fonte do Astra para o Rank Math resolve a duplicidade

Sim, na maioria dos casos. Com a fonte do Astra definida como Rank Math, o tema deixa de desenhar a trilha própria e passa a exibir a do plugin na posicao escolhida, resultando em uma única trilha e um único dado estruturado por página.

Ainda vejo duas trilhas mesmo após mudar a configuração do Astra

Provavelmente ha uma chamada manual de breadcrumb no tema filho ou um widget de trilha no cabeçalho montado pelo construtor. Revise o single.php e o template do cabeçalho, remova a chamada excedente, limpe o cache e confira o código-fonte de novo.

Os breadcrumbs duplicados prejudicam o SEO do site

A trilha visivel duplicada confunde o visitante, e dois blocos BreadcrumbList na mesma URL podem gerar avisos no Teste de Resultados Aprimorados do Google. Não costuma derrubar ranking, mas deixa o dado estruturado inconsistente e vale corrigir para um único BreadcrumbList.

Preciso limpar o cache depois de corrigir a trilha

Sim. Plugins de cache e a CDN podem servir a versão antiga da página com as duas trilhas. Limpe o cache de página, de objeto e da CDN e recarregue a URL antes de validar, senao você ve a duplicidade que já foi resolvida.

Grave

Como corrigir sitemap XML com erro no WordPress

O sitemap XML com erro no WordPress acontece quando o arquivo /sitemap_index.xml ou /wp-sitemap.xml não abre, aparece em branco ou é rejeitado pelo Google Search Console. Quase sempre vem de PHP/HTML vazando para dentro do XML, de um plugin de cache servindo a versão errada ou de permalinks não regenerados.

Grave

Como corrigir o schema de produto do Rank Math no WooCommerce

O schema de produto do Rank Math no WooCommerce fica invalido quando o markup sai sem offers, review ou aggregateRating, quando aparece em páginas de arquivo, ou quando o WooCommerce duplica a marcacao Product.

Informativo

Como corrigir o erro de llms.txt no SEOPress

O erro de llms.txt no SEOPress acontece quando o recurso esta desligado no painel ou quando as regras de reescrita do WordPress não foram atualizadas, fazendo o endereco /llms.txt retornar 404 ou vir em branco.

Grave

Como corrigir o sitemap do Rank Math que não submete ao Google Search Console

O Search Console rejeita o sitemap do Rank Math na submissão quando o sitemap_index.xml devolve 404, HTML, redirecionamento ou um arquivo estático no disco no lugar do XML virtual. A URL só é aceita depois que a rota, o cache e o robots.txt liberam o XML puro.

Informativo

Como corrigir o Content Analysis que não atualiza o score no SEOPress

O SEOPress Content Analysis não atualiza o score quando você não informa uma palavra-chave alvo, não salva o post antes de reanalisar, ou a metabox de análise está oculta nas configurações de aparência do plugin.

Informativo

Como corrigir o score baixo no Content Analysis do Rank Math no WordPress

O Rank Math content score baixo aparece quando a Focus Keyword não esta preenchida ou não casa com título, URL e primeiro paragrafo, deixando o Content Analysis reprovar os testes basicos de SEO no editor.

Setores

Extensões

Integrações

Como corrigir Breadcrumbs duplicados entre Astra Pro e Rank Math

O que é breadcrumbs duplicados entre Astra Pro e Rank Math?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir sitemap XML com erro no WordPress

Como corrigir o schema de produto do Rank Math no WooCommerce

Como corrigir o erro de llms.txt no SEOPress

Como corrigir o sitemap do Rank Math que não submete ao Google Search Console

Como corrigir o Content Analysis que não atualiza o score no SEOPress

Como corrigir o score baixo no Content Analysis do Rank Math no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos