--- title: "Como corrigir o Mini Cart que não exibe corretamente no Astra Pro com WooCommerce" url: https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o Mini Cart que não exibe corretamente no Astra Pro com WooCommerce ## O que é o Astra mini cart do WooCommerce que não aparece? O Mini Cart do Astra e o icone de carrinho que fica no cabeçalho e, ao clicar ou passar o mouse, abre um resumo com os itens do WooCommerce sem sair da página. No Header Builder novo do Astra ele e um elemento chamado Cart (Carrinho); no header antigo, era adicionado como último item do menu. A contagem e a atualização em tempo real dependem do script wc-cart-fragments do WooCommerce, que faz uma requisicao AJAX a cada alteração do carrinho. Quando esse elemento não esta no header ou o AJAX e bloqueado, o mini cart some, abre vazio ou não atualiza a quantidade. ## Como identificar - O icone do carrinho não aparece no cabeçalho mesmo com o WooCommerce ativo e produtos no catalogo. - Ao clicar no icone, o dropdown do mini cart abre vazio ou não abre, embora haja itens no carrinho. - A janela do mini cart fica transparente e ilegivel sobre o conteúdo da página, sem fundo solido. - O contador de itens ao lado do icone trava em zero e so muda depois de recarregar a página inteira. - O console do navegador mostra falha ao carregar wc-cart-fragments.min.js ou erro de JavaScript no header. **Antes de começar:** Antes de editar o functions.php do tema filho ou adicionar snippets, faca backup do arquivo e do banco. Um erro de sintaxe no PHP derruba o site com erro crítico, e e mais seguro usar um plugin de snippets ou testar primeiro em staging. ## Como prevenir - Após migrar do header antigo para o Header Builder, confirme que o elemento Carrinho foi readicionado e publicado - Mantenha wc-cart-fragments e o cookie woocommerce_cart_hash sempre fora das otimizacoes e do cache de página - Atualize Astra e Astra Pro juntos e teste o mini cart em staging antes de aplicar otimizacoes de cache em producao Erros relacionados - [Como corrigir o erro de Header/Footer no Astra Pro após atualização](https://full.services/wp-fixer/corrigir-header-footer-astra-pro/) - [Como corrigir Custom Layouts que não aplicam no Astra Pro](https://full.services/wp-fixer/corrigir-custom-layouts-astra-pro/) - [Como corrigir a página de produto do WooCommerce que quebra com o Astra Pro](https://full.services/wp-fixer/corrigir-product-page-woocommerce-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-mini-cart-woocommerce-astra-pro/#article", "headline": "Como corrigir o Mini Cart que não exibe corretamente no Astra Pro com WooCommerce", "url": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:08-03:00", "dateModified": "2026-06-17T12:39:08-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": "Page Builders" } ], "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-mini-cart-woocommerce-astra-pro/" }, "wordCount": 800, "description": "O Astra mini cart do WooCommerce que não aparece deixa o icone ausente no header, abre um dropdown vazio ou exibe a janela transparente. A causa quase sempre e o elemento Cart não adicionado no Header Builder, o script wc-cart-fragments bloqueado pelo cache, ou o filtro de fundo do outline cart desligado após migrar do header antigo.", "articleSection": "Page Builders", "keywords": "astra header builder cart vazio, astra mini cart nao abre, contador do carrinho astra nao atualiza, icone do carrinho nao aparece astra woocommerce, mini cart astra pro transparente", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://wpastra.com/docs/add-woocommerce-mini-cart-to-header/", "name": "Astra — How to Add WooCommerce Mini Cart in Header" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o Mini Cart que não exibe corretamente no Astra Pro com WooCommerce", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq-q1", "name": "O icone do carrinho sumiu do header depois de mudar o cabeçalho. Por que?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Ao migrar para o Header Builder do Astra, o elemento Carrinho não e movido sozinho. Abra Aparencia, Personalizar e Header Builder, arraste o elemento Carrinho de volta para a área do cabeçalho e publique. No header antigo, o caminho e definir o último item do menu como WooCommerce.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq-q2", "name": "O mini cart abre vazio mesmo com itens no carrinho. Como resolver?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Quase sempre e o script wc-cart-fragments bloqueado pelo cache. Exclua esse script da minificacao e do adiamento de JS, impeca o cache de página de servir o carrinho e mantenha o cookie woocommerce_cart_hash fora do cache. Sem o AJAX dele, o dropdown abre sem os itens.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq-q3", "name": "O contador de itens trava em zero. O que esta errado?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "A página esta sendo servida do cache com o estado antigo do carrinho. Configure o plugin de cache para não cachear o cookie woocommerce_cart_hash e excluir as páginas de carrinho e checkout. Assim o WooCommerce atualiza a contagem via fragments sem recarregar a página inteira.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq-q4", "name": "Por que o mini cart fica transparente e ilegivel?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Esse e um problema conhecido ao migrar do header antigo para o Header Footer Builder do Astra. O fundo do outline cart deixa de ser aplicado. A correção oficial e reativar o filtro astra_apply_background_to_outline_cart_builder_element, disponível a partir do Astra 3.6.7, num plugin de snippets ou no tema filho.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq-q5", "name": "Qual a diferenca entre Dropdown e Slide-In no carrinho do Astra?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Dropdown abre um pequeno resumo logo abaixo do icone, e Slide-In (Off-Canvas) desliza um painel lateral com o carrinho. Ambos são escolhidos em Aparencia, Personalizar, Header Builder, Carrinho. Se o Slide-In não abre, troque para Dropdown para descartar que um plugin removeu o markup do painel lateral.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq-q6", "name": "Posso exibir o mini cart fora do cabeçalho?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. O Astra oferece um shortcode de mini cart que pode ser colocado em páginas, widgets ou construtores. Adicione o carrinho ao header como Slide-In e use o shortcode astra_woo_mini_cart onde quiser que o icone apareca, mantendo o mesmo comportamento do cabeçalho.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-mini-cart-woocommerce-astra-pro/#faq-q7", "name": "Preciso do Astra Pro para ter o mini cart do WooCommerce?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O Astra gratuito já exibe o icone do carrinho no header. O Astra Pro amplia o controle: estilos de Off-Canvas, posicionamento no Header Builder e opções visuais do icone e do contador. Se o icone sumiu, primeiro confirme o elemento no Header Builder antes de suspeitar da licenca Pro.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```