--- title: "Como corrigir o erro de Breadcrumbs no Astra Pro" url: https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o erro de Breadcrumbs no Astra Pro ## 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 titulo 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 Erros relacionados - [Como corrigir Breadcrumbs duplicados entre Astra Pro e Rank Math](https://full.services/wp-fixer/corrigir-breadcrumbs-duplicados-astra-pro-rank-math/) - [Como corrigir breadcrumbs duplicados entre SEOPress e Astra Pro](https://full.services/wp-fixer/corrigir-breadcrumbs-duplicados-seopress-astra/) - [Como corrigir o erro de Schema Markup no Astra Pro](https://full.services/wp-fixer/corrigir-schema-markup-astra-pro/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#article", "headline": "Como corrigir o erro de Breadcrumbs no Astra Pro", "url": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:31-03:00", "dateModified": "2026-06-17T12:39:31-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": false, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "SEO Tecnico" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/" }, "wordCount": 769, "description": "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.", "articleSection": "SEO Tecnico", "keywords": "astra breadcrumb fonte rank math, astra breadcrumb sumiu customizer, ativar breadcrumb tema astra, breadcrumb astra pro nao exibe, shortcode astra_breadcrumb nao funciona", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://wpastra.com/docs/breadcrumbs/", "name": "Astra Docs — Find the Way With Breadcrumbs" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o erro de Breadcrumbs no Astra Pro", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq-q1", "name": "Por que o breadcrumb do Astra não aparece em nenhuma página?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq-q2", "name": "Onde fica a configuração de breadcrumb no Astra?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq-q3", "name": "O breadcrumb sumiu depois que ativei um plugin de SEO. Por que?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq-q4", "name": "O shortcode astra_breadcrumb não funciona. O que falta?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq-q5", "name": "Uso o Header Builder e o breadcrumb não aparece no cabeçalho. Por que?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq-q6", "name": "Como inserir o breadcrumb do Astra em um template via código?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-breadcrumbs-astra-pro/#faq-q7", "name": "O breadcrumb aparece na home mas some em posts. E normal?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Quase sempre e um Custom Layout ou Page Header do Astra Pro que substitui a área do titulo 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.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```