Breadcrumbs SEOPress não exibem: como corrigir

Tipo SEO Tecnico

Nome do erro Breadcrumbs não exibem no SEOPress EN: SEOPress breadcrumbs not showing

Severidade Atenção

Descrição Os breadcrumbs SEOPress não exibem no frontend quando a opção em SEO -> PRO -> Breadcrumbs está desligada ou quando o tema nunca chama a função do plugin. Ativar a opção apenas registra o recurso, que é exclusivo do SEOPress PRO; sem o ponto de chamada no template, a trilha de navegação não renderiza.

O que é o erro de breadcrumbs SEOPress que não exibem?

Breadcrumbs são a trilha de navegação (por exemplo, Início, Categoria, Post) que mostra ao visitante onde ele está na hierarquia do site e fornece ao Google o dado estruturado BreadcrumbList. No SEOPress, o recurso de breadcrumbs é exclusivo do SEOPress PRO e tem duas partes independentes: a opção que ativa a geração da trilha em SEO -> PRO -> Breadcrumbs e o ponto de exibição, que precisa ser inserido no site via função PHP, shortcode ou bloco do Gutenberg. Quando os breadcrumbs não exibem, ou a opção está desligada, ou nenhum ponto de chamada foi adicionado, ou o tema gera a página por um caminho que ignora esse ponto. Ativar a opção sozinha não desenha nada na tela: ela só habilita a função para ser chamada.

Como identificar

A trilha de navegação não aparece em nenhum post ou página, mesmo com a opção Enable Breadcrumbs marcada em SEO -> PRO -> Breadcrumbs.
A mensagem do editor mostra Breadcrumbs disponível como bloco do Gutenberg, mas no frontend o bloco renderiza vazio ou some.
O shortcode seopress_breadcrumbs aparece como texto cru entre colchetes na página, em vez de virar a trilha.
O Teste de Resultados Aprimorados do Google não detecta o dado estruturado BreadcrumbList na URL, mesmo com a opção JSON-LD ligada.
O breadcrumb aparece em posts, mas não em páginas, arquivos ou produtos WooCommerce, porque só um template recebeu o ponto de chamada.

Antes de começar: Antes de editar o single.php ou o header.php, faça backup e trabalhe sempre em um tema filho. Editar o tema pai faz o ponto de chamada do breadcrumb desaparecer na próxima atualização do tema.

Como prevenir

Documente onde o ponto de chamada do breadcrumb foi inserido (bloco, shortcode ou função no single.php) para não perdê-lo em uma troca de tema
Use um tema filho para que a chamada da função do SEOPress sobreviva às atualizações do tema
Após ativar a trilha, valide o BreadcrumbList no Teste de Resultados Aprimorados do Google e mantenha uma só fonte de breadcrumb ativa para evitar duplicidade

Causa

A opção Enable Breadcrumbs está desmarcada em SEO -> PRO -> Breadcrumbs, então a função seopress_display_breadcrumbs nunca gera a trilha.
A versão instalada é o SEOPress gratuito; breadcrumbs é recurso exclusivo do SEOPress PRO e a aba Breadcrumbs nem existe sem a licença ativada.
A opção está ativa, mas nenhum ponto de exibição foi adicionado: o tema não chama seopress_display_breadcrumbs no template, o shortcode não foi inserido e o bloco não foi colocado.
O shortcode seopress_breadcrumbs foi colado em um widget ou área que não processa shortcodes (por exemplo, um campo de texto puro), então o código aparece literal.
Um construtor de páginas (Elementor, Divi) renderiza o single por um template próprio que ignora o single.php onde a função PHP foi inserida.
Um plugin de cache (WP Rocket, LiteSpeed) está servindo uma versão da página gerada antes de a trilha ser ativada.

Como resolver

Confirme que o SEOPress PRO está ativo: breadcrumbs é recurso exclusivo do SEOPress PRO. Verifique se o plugin PRO está instalado e a licença ativada, senão a aba de breadcrumbs nem aparece no menu.
```
SEO -> PRO -> Breadcrumbs
```
Ative a opção e defina o separador: na aba Breadcrumbs, marque Enable Breadcrumbs, escolha o separador e salve. Se quiser a trilha visível também para os mecanismos de busca, ligue a opção de breadcrumbs em JSON-LD.
```
SEO -> PRO -> Breadcrumbs -> Enable Breadcrumbs
```
Adicione um ponto de exibição no conteúdo: para páginas e posts montados no editor, use o bloco Breadcrumbs do Gutenberg ou o shortcode dentro do conteúdo. Esse é o caminho que não exige editar código.
```
[seopress_breadcrumbs]
```
Chame a função no template do tema: se a trilha precisa sair no cabeçalho de todos os posts, insira a função do SEOPress no single.php do tema filho, logo após a abertura do conteúdo. Use a forma com false quando precisar capturar o HTML em uma variável em vez de imprimir direto.
```
seopress_display_breadcrumbs();
$trilha = seopress_display_breadcrumbs( false );
```
Cubra os templates do construtor de páginas: se o single é montado no Elementor ou Divi, o ponto de chamada do single.php é ignorado. Insira o widget de shortcode com a tag do SEOPress no topo do template do construtor para a trilha aparecer.
```
[seopress_breadcrumbs]
```
Limpe o cache e valide o dado estruturado: limpe o cache do site e do CDN para servir a versão nova e rode o Teste de Resultados Aprimorados do Google na URL para confirmar que o BreadcrumbList é detectado.
```
https://search.google.com/test/rich-results
```

PHP

// single.php do tema filho — exibe a trilha do SEOPress no topo do post
// Protege contra erro fatal caso o SEOPress PRO esteja inativo ou seja desativado
if ( function_exists( 'seopress_display_breadcrumbs' ) ) {
    seopress_display_breadcrumbs();
}

// Variante: captura o HTML da trilha numa variavel em vez de imprimir direto
// Util para inserir o breadcrumb dentro de um wrapper proprio do tema
if ( function_exists( 'seopress_display_breadcrumbs' ) ) {
    $seopress_trilha = seopress_display_breadcrumbs( false );
    echo '<div class="meu-breadcrumb">' . $seopress_trilha . '</div>';
}

Perguntas frequentes

Por que os breadcrumbs do SEOPress não aparecem mesmo com a opção ativada?

Porque ativar Enable Breadcrumbs em SEO -> PRO só habilita a função; o site ainda precisa de um ponto de exibição. Adicione o bloco Breadcrumbs, o shortcode seopress_breadcrumbs ou a função seopress_display_breadcrumbs no template do tema filho para a trilha renderizar.

Breadcrumbs é recurso gratuito do SEOPress?

Não. Breadcrumbs é um recurso exclusivo do SEOPress PRO. Na versão gratuita a aba Breadcrumbs nem aparece no menu, então você precisa instalar o SEOPress PRO e ativar a licença antes de configurar a trilha.

Qual a diferença entre o bloco, o shortcode e a função do SEOPress?

O bloco Breadcrumbs e o shortcode seopress_breadcrumbs servem para inserir a trilha dentro do conteúdo de um post ou página, sem código. A função seopress_display_breadcrumbs vai no template PHP do tema e serve para mostrar a trilha de forma automática em todos os posts.

O shortcode aparece como texto entre colchetes na página. O que houve?

Você colou o shortcode em uma área que não processa shortcodes, como um campo de texto puro ou um widget HTML cru. Use o bloco de shortcode do editor, o bloco Breadcrumbs nativo ou insira a função PHP no template para o SEOPress interpretar a tag.

Como exibir o breadcrumb no topo de todos os posts?

Insira a função seopress_display_breadcrumbs no single.php do tema filho, logo após a abertura do conteúdo. Assim a trilha sai automaticamente em cada post sem você precisar adicionar o bloco ou o shortcode manualmente em cada um.

O breadcrumb aparece nos posts mas não nas páginas. Por quê?

Porque o ponto de chamada foi inserido só no template de post, geralmente o single.php. Adicione a função ou o bloco também no template de página, no de arquivo e no de produto, ou use o widget no construtor que monta esses modelos.

Preciso validar o breadcrumb do SEOPress no Google?

Sim, é recomendado. Ligue a opção de breadcrumbs em JSON-LD e rode o Teste de Resultados Aprimorados na URL para confirmar que o dado estruturado BreadcrumbList é detectado sem erros, garantindo que o caminho do site possa aparecer no resultado de busca.

Atenção

Como corrigir as permissões do Role Manager no Rank Math

As permissões do Role Manager no Rank Math controlam quais funções do plugin cada perfil do WordPress enxerga; quando mal configuradas ou com o módulo desativado, editores e autores perdem menus inteiros e veem o erro de acesso negado.

Grave

Como corrigir o sitemap XML que não gera no SEOPress

Quando o sitemap do SEOPress não funciona, o arquivo em seudominio.com/sitemaps.xml/ devolve 404, página em branco ou e tratado como HTML pelo Search Console. A causa costuma ser a opção do sitemap desligada em SEO -> XML – HTML Sitemap, links permanentes em Simples sem reescrita, ou cache servindo uma versão antiga.

Informativo

Como corrigir o Broken Link Checker no SEOPress

O erro do Broken Link Checker no SEOPress acontece quando o scan de links quebrados não roda, não retorna resultados ou trava, geralmente porque o recurso so existe no SEOPress PRO, o WP-Cron esta inativo ou o limite de execução do servidor interrompe o bot antes de terminar a varredura.

Grave

Como corrigir o redirecionamento 301 que não funciona no SEOPress

No SEOPress PRO, um redirecionamento 301 só dispara quando o toggle Enable redirection está ativo, a URL de origem é relativa, a de destino é absoluta e nenhum redirect de servidor intercepta a URL antes do WordPress carregar.

Grave

Como corrigir problemas de indexação do sitemap Rank Math no Google

O sitemap do Rank Math fica como Couldn't fetch no Search Console quando o sitemap_index.xml retorna 404, HTML ou XML com lixo antes da abertura. O Google só lê o arquivo depois que a rota, o cache e o robots.txt liberam a saída XML pura.

Atenção

Como corrigir canibalizacao de keyword no WordPress com Rank Math

A canibalizacao de keyword no WordPress ocorre quando duas ou mais páginas do mesmo site disputam o mesmo termo de busca, dividindo cliques, autoridade e sinais de relevancia. O Rank Math ajuda a detectar a focus keyword repetida e a corrigir com consolidacao, canonical ou redirecionamento 301.

Setores

Extensões

Integrações

Como corrigir os breadcrumbs que não exibem no SEOPress

O que é o erro de breadcrumbs SEOPress que não exibem?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir as permissões do Role Manager no Rank Math

Como corrigir o sitemap XML que não gera no SEOPress

Como corrigir o Broken Link Checker no SEOPress

Como corrigir o redirecionamento 301 que não funciona no SEOPress

Como corrigir problemas de indexação do sitemap Rank Math no Google

Como corrigir canibalizacao de keyword no WordPress com Rank Math

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