Astra breadcrumbs não aparece: como corrigir no Astra Pro

Tipo SEO Tecnico

Nome do erro Breadcrumbs não aparecem no Astra Pro EN: Astra Pro breadcrumbs not showing

Severidade Atenção

Descrição Astra breadcrumbs não aparece quando a posicao do breadcrumb esta definida como None no Customizer, ou quando a fonte selecionada aponta para um plugin de SEO (Yoast, Rank Math, SEOPress) cujo recurso de breadcrumb esta desativado. O Astra entao não tem o que renderizar e a trilha some.

O que é o erro de breadcrumbs no Astra Pro?

O breadcrumb do Astra e a trilha de navegação (Inicio depois Categoria depois Página atual) que o tema exibe acima do conteúdo. O Astra oferece duas formas de gera-la: a trilha nativa do próprio tema ou a trilha de um plugin de SEO ativo. Em Layout depois Breadcrumb você escolhe a posicao (None, Inside Header, After Header ou Before Title) e a fonte. O erro de breadcrumbs aparece quando a posicao esta em None ou a fonte aponta para um plugin cujo breadcrumb próprio não foi ativado: nesses casos o Astra não injeta nenhuma trilha e o usuário ve o conteúdo sem a navegação esperada.

Como identificar

Nenhuma trilha de navegação aparece acima do título das páginas, mesmo com o tema Astra Pro ativo.
No Customizer, em Layout depois Breadcrumb, o campo Position esta definido como None.
O breadcrumb aparece na home mas some em posts, páginas ou arquivos de categoria especificos.
O shortcode astra_breadcrumb colocado numa página não renderiza nada ou retorna o texto cru entre colchetes.
A fonte do breadcrumb esta definida para Rank Math ou Yoast, mas o recurso de breadcrumb desse plugin esta desligado.

Antes de começar: Antes de editar qualquer arquivo de template do tema filho para inserir a função de breadcrumb, faca backup do arquivo. Uma chamada PHP colocada fora de contexto pode gerar erro fatal e derrubar a página.

Como prevenir

Após qualquer mudanca de tema ou plugin de SEO, abra o Personalizar e confirme se a posicao do breadcrumb continua em Inside Header, After Header ou Before Title
Defina uma única fonte de breadcrumb (Astra nativo ou um plugin de SEO) e mantenha o recurso desse plugin ligado para evitar trilha vazia
Ao publicar uma página crítica, abra o código-fonte e confirme que a trilha esta presente antes de divulgar a URL

Causa

A opção Position do breadcrumb esta definida como None em Aparencia, Personalizar, Layout, Breadcrumb (a trilha so renderiza em Inside Header, After Header ou Before Title).
A fonte (Breadcrumb Source) esta definida para um plugin de SEO, mas o recurso de breadcrumb desse plugin esta desativado: Yoast usa yoast_breadcrumb(), Rank Math usa rank_math_the_breadcrumbs() e Breadcrumb NavXT usa bcn_display(), e nenhum retorna saida se estiver desligado.
O shortcode astra_breadcrumb foi usado com o plugin Astra Pro inativo: a trilha por shortcode exige o Astra Pro instalado e ativado.
O Astra esta em modo Header Builder e o elemento Breadcrumb não foi arrastado para nenhuma linha do cabeçalho, entao a área Inside Header fica vazia.
Uma regra de Custom Layout ou um Page Header do Astra Pro substitui a área do título e remove o bloco onde a posicao Before Title injetaria a trilha.

Como resolver

Defina uma posicao valida no Customizer: abra o Personalizar do WordPress e va até a seção de Breadcrumb dentro de Layout. O campo de posicao precisa estar em uma das três opções que renderizam, nunca em None. Escolha a posicao desejada e publique.
```
Aparencia -> Personalizar -> Layout -> Breadcrumb
Position: Inside Header | After Header | Before Title
```
Confira a fonte do breadcrumb: ainda na seção de Breadcrumb, verifique a fonte selecionada. Se ela apontar para um plugin de SEO, esse plugin precisa estar com o recurso de breadcrumb ligado, senao o Astra não recebe nenhuma trilha para exibir. Em caso de duvida, volte a fonte para a opção nativa do Astra.
```
Breadcrumb Source: Astra Default Breadcrumb
Yoast SEO -> habilitar yoast_breadcrumb()
Rank Math -> habilitar rank_math_the_breadcrumbs()
```
Garanta o elemento no Header Builder: se o site usa o Header Builder do Astra e a posicao escolhida foi dentro do cabeçalho, arraste o elemento de breadcrumb para uma linha do cabeçalho. Sem o elemento posicionado, a área fica vazia mesmo com a fonte correta.
```
Personalizar -> Header Builder -> arrastar o elemento Breadcrumb para uma linha
```
Use o shortcode com o Astra Pro ativo: para exibir a trilha em um ponto fora das três posicoes padrão, use o shortcode do Astra dentro do editor ou de um widget. Esse recurso depende do Astra Pro instalado e ativado: confirme isso em Plugins antes de colar o shortcode.
```
[astra_breadcrumb]
```
Insira a trilha via código no template: se você edita o tema filho e quer forcar a trilha em um arquivo de template, chame a função do Astra que respeita a fonte selecionada no Customizer. Coloque a chamada no ponto do template onde a navegação deve aparecer.
```
echo astra_get_selected_breadcrumb();
```

PHP

<?php
// Fallback no tema filho: mostra a trilha do Astra so quando ela existe.
// Respeita a fonte (Astra, Yoast, Rank Math, NavXT) escolhida no Customizer.
if ( function_exists( 'astra_get_selected_breadcrumb' ) ) {
    $trail = astra_get_selected_breadcrumb( false ); // false = retorna em vez de imprimir
    if ( ! empty( $trail ) ) {
        echo '<nav class="ast-breadcrumbs-fallback" aria-label="breadcrumb">';
        echo $trail;
        echo '</nav>';
    }
}

Perguntas frequentes

Por que o breadcrumb do Astra não aparece em nenhuma página?

Quase sempre porque a posicao esta definida como None em Layout, Breadcrumb no Customizer. A trilha so renderiza nas posicoes Inside Header, After Header ou Before Title. Troque a posicao e publique para a navegação voltar a aparecer.

Onde fica a configuração de breadcrumb no Astra?

Em Aparencia, Personalizar, Layout, Breadcrumb. Ali você escolhe a posicao e a fonte da trilha. As opções de estilo, como cor do separador e espacamento, ficam na aba Design da mesma seção.

O breadcrumb sumiu depois que ativei um plugin de SEO. Por que?

Porque a fonte do breadcrumb foi trocada para o plugin de SEO, mas o recurso de breadcrumb desse plugin esta desligado. Ligue o breadcrumb no Yoast ou Rank Math, ou volte a fonte para a trilha nativa do Astra.

O shortcode astra_breadcrumb não funciona. O que falta?

Esse shortcode exige o plugin Astra Pro instalado e ativado. Sem o Astra Pro ativo, o shortcode não e registrado e o WordPress mostra o texto cru entre colchetes. Confirme o Astra Pro em Plugins e tente de novo.

Uso o Header Builder e o breadcrumb não aparece no cabeçalho. Por que?

No Header Builder do Astra, o breadcrumb so renderiza dentro do cabeçalho se o elemento de breadcrumb estiver posicionado em alguma linha. Arraste o elemento para a linha desejada no Personalizar e publique.

Como inserir o breadcrumb do Astra em um template via código?

Chame a função astra_get_selected_breadcrumb() no arquivo do tema filho, no ponto onde a trilha deve aparecer. Ela respeita a fonte escolhida no Customizer e retorna o HTML da trilha ativa, seja a nativa ou a de um plugin de SEO.

O breadcrumb aparece na home mas some em posts. E normal?

Quase sempre e um Custom Layout ou Page Header do Astra Pro que substitui a área do título nesses tipos de conteúdo e remove o ponto onde a posicao Before Title injetaria a trilha. Revise o layout aplicado ao tipo de post afetado.

Atenção

Como corrigir meta tags que não aplicam em templates Elementor no SEOPress no WordPress

O SEOPress Elementor meta tags não aplica quando o tema imprime o próprio título, quando o tipo de conteúdo esta sem template em Titles & Metas, ou quando o cache serve uma versão antiga. O resultado e título errado, meta description vazia ou tag de título duplicada na página do Elementor.

Atenção

Como corrigir o erro de Open Graph no SEOPress

O erro de Open Graph no SEOPress acontece quando o plugin não emite as tags og:title, og:description e og:image, entao a previa do link sai sem imagem ou com título errado no Facebook e no WhatsApp. As causas comuns são o Open Graph desativado em Social Networks, a falta de imagem destacada ou padrão, ou outro plugin duplicando a tag.

Atenção

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.

Atenção

Como corrigir breadcrumbs duplicados entre SEOPress e Astra Pro no WordPress

Breadcrumbs duplicados entre SEOPress e Astra Pro acontecem quando o tema e o plugin renderizam a trilha de navegação ao mesmo tempo, ou quando o bloco, shortcode ou função PHP do SEOPress e somado ao breadcrumb que o Astra já exibe no cabeçalho da página.

Atenção

Como corrigir rich snippets inválidos no Schema do WordPress

Rich snippets schema inválido é quando a marcação JSON-LD da página existe, mas o Rich Results Test do Google a rejeita por campo obrigatório ausente ou tipo incorreto, então o resultado rico nunca aparece na busca.

Atenção

Como corrigir o schema de Local SEO no Rank Math

O Local SEO do Rank Math não funciona quando o schema LocalBusiness não e emitido ou o Google o ignora. As causas mais comuns são o Knowledge Graph definido como Pessoa, o campo Tipo de Negocio em branco e a ausencia de GeoCoordinates ou horario, todos em Títulos e Meta na aba Local SEO.

Setores

Extensões

Integrações

Como corrigir o erro de Breadcrumbs no Astra Pro

O que é o erro de breadcrumbs no Astra Pro?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir meta tags que não aplicam em templates Elementor no SEOPress no WordPress

Como corrigir o erro de Open Graph no SEOPress

Como corrigir breadcrumb que não aparece no WordPress

Como corrigir breadcrumbs duplicados entre SEOPress e Astra Pro no WordPress

Como corrigir rich snippets inválidos no Schema do WordPress

Como corrigir o schema de Local SEO no 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