# Como corrigir breadcrumb que não aparece no WordPress

O breadcrumb que não aparece no WordPress costuma vir da opção de trilha desligada no plugin de SEO ou da ausência da função de chamada no tema. Sem o breadcrumb, o site perde a trilha de navegação visível e o dado estruturado que o Google usa para mostrar o caminho do site nos resultados de busca.

## O que é o breadcrumb que não aparece no WordPress?

O breadcrumb é a trilha de navegação (por exemplo, Início, Categoria, Post) que mostra ao visitante onde ele está na hierarquia do site e ajuda o Google a entender essa estrutura. Quando o breadcrumb não aparece, ou a opção está desativada no plugin de SEO, ou o tema não tem o ponto de chamada que renderiza a trilha. Sem ele, o site perde o recurso de breadcrumb nos resultados de busca, gerado pelo dado estruturado correspondente.

## Como identificar

- A trilha de navegação some do topo dos posts e páginas, mesmo com o breadcrumb ativado no plugin de SEO.
- O Teste de Resultados Aprimorados do Google não detecta o dado estruturado de breadcrumb na URL.
- No Search Console, o relatório de Navegação estrutural (breadcrumbs) fica vazio ou some após uma troca de tema.
- O breadcrumb aparece em alguns modelos (post) mas não em outros (página, arquivo ou produto).

**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 a chamada do breadcrumb desaparecer na próxima atualização do tema.

## Como prevenir

- Ao trocar de tema, confirme se o ponto de chamada do breadcrumb foi mantido no novo template
- Use um tema filho para que a chamada do breadcrumb não se perca nas atualizações do tema
- Após ativar a trilha, valide o dado estruturado no Teste de Resultados Aprimorados do Google

Erros relacionados

- [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/)
- [Como corrigir meta description não aparecendo no Google](https://full.services/wp-fixer/corrigir-meta-description-nao-aparece-wordpress/)
- [Como corrigir páginas com noindex acidental no WordPress](https://full.services/wp-fixer/corrigir-noindex-acidental-wordpress/)

## Causa

- A opção de breadcrumbs está desligada nas configurações do plugin de SEO (Rank Math ou Yoast).
- O tema não tem o ponto de chamada do breadcrumb no single.php ou no header.php, então a função do plugin nunca é executada.
- O tema usa um sistema de breadcrumb próprio que foi desativado ou removido em uma atualização.
- Um construtor de páginas (Elementor, Divi) renderiza o modelo sem incluir o widget de breadcrumb no cabeçalho.
- Um plugin de cache está servindo uma versão antiga da página, gerada antes de o breadcrumb ser ativado.

## Como resolver

1. Ative os breadcrumbs no plugin de SEO: no Rank Math, em Configurações Gerais, Breadcrumbs, ative a função; no Yoast, em Aparência na Busca, Breadcrumbs, ligue a opção. Salve.
2. Verifique se o tema já mostra a trilha: alguns temas chamam o breadcrumb automaticamente ao ativar a opção. Recarregue um post e veja se a trilha apareceu antes de mexer no código.
3. Adicione o ponto de chamada no tema: se a trilha não surgir, insira a função do plugin no template, logo após a abertura do conteúdo. Use o snippet do plugin de SEO correspondente no single.php do tema filho.

```
o código PHP if ( function_exists( 'rank_math_the_breadcrumbs' ) ) rank_math_the_breadcrumbs();
```

4. Use o widget no construtor de páginas: se o modelo é montado no Elementor ou Divi, arraste o widget de breadcrumb para o topo do template em vez de editar o PHP, para o construtor não sobrescrever a trilha.
5. Limpe o cache e valide o dado estruturado: limpe o cache do site e do CDN e rode o Teste de Resultados Aprimorados do Google na URL para confirmar que o dado estruturado de breadcrumb é detectado.

## Código

```php
// single.php do tema filho — exibe o breadcrumb do plugin de SEO de forma segura
// Funciona tanto com Rank Math quanto com Yoast, sem quebrar se o plugin estiver inativo
if ( function_exists( 'rank_math_the_breadcrumbs' ) ) {
    rank_math_the_breadcrumbs();
} elseif ( function_exists( 'yoast_breadcrumb' ) ) {
    yoast_breadcrumb( '<nav class="breadcrumb">', '</nav>' );
}
```

## Perguntas frequentes

### Para que serve o breadcrumb no WordPress?

Ele mostra a trilha de navegação da página (Início, Categoria, Post), ajuda o visitante a se localizar e fornece ao Google um dado estruturado que pode exibir o caminho do site nos resultados de busca, no lugar da URL pura.

### Por que o breadcrumb não aparece mesmo ativado no plugin?

Porque ativar no plugin só habilita a função; o tema precisa chamá-la no template. Se o tema não tem esse ponto de chamada, a trilha não renderiza. Você precisa inserir a função do breadcrumb no single.php do tema filho.

### Como adicionar o breadcrumb sem editar código?

Se o site usa um construtor como Elementor ou Divi, arraste o widget de breadcrumb para o topo do modelo. Muitos temas modernos também exibem a trilha automaticamente assim que você ativa a opção no plugin de SEO.

### O breadcrumb melhora o SEO?

Ele não é fator direto de ranqueamento, mas melhora a navegação e gera o dado estruturado de breadcrumb, que pode aparecer no resultado de busca. Isso deixa o snippet mais claro e tende a aumentar os cliques.

### O breadcrumb sumiu depois de trocar de tema. O que houve?

O tema anterior chamava a função do breadcrumb no template e o novo não chama. Adicione o ponto de chamada do plugin de SEO no single.php do novo tema filho ou use o widget do construtor para a trilha voltar.

### Preciso validar o breadcrumb no Google?

Sim, é recomendado. Rode o Teste de Resultados Aprimorados na URL para confirmar que o dado estruturado de breadcrumb é detectado sem erros. Depois, acompanhe o relatório de Navegação estrutural no Search Console.

**Fonte:** [Google Search Central — Breadcrumb structured data](https://developers.google.com/search/docs/appearance/structured-data/breadcrumb)