--- title: "Como corrigir o erro de CSS no Customizer do Astra Pro" url: https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o erro de CSS no Customizer do Astra Pro ## O que é o erro do Astra Customizer CSS que não aplica? O Astra Customizer CSS que não aplica e a falha em que você escreve regras em Aparencia -> Personalizar -> CSS Adicional, clica em Publicar com o Astra Pro ativo, mas o estilo não muda no site. O CSS Adicional do WordPress grava as regras num tipo de post chamado custom_css, vinculado ao tema ativo, e imprime esse bloco no cabeçalho da página por meio da função wp_custom_css_cb dentro do wp_head. O Astra Pro, por sua vez, gera o próprio CSS dinamico (cores globais, tipografia, layout) e o imprime inline na página. Quando o cache entrega um head antigo, quando o CSS dinamico do Astra Pro vem depois e ganha por especificidade, ou quando o CSS Adicional foi salvo sob outro tema, a regra do Personalizar simplesmente não aparece no resultado final. ## Como identificar - Você salva uma regra em Personalizar -> CSS Adicional, o preview do lado direito muda, mas no site publicado o estilo continua igual. - No inspetor do navegador (F12 -> Elements -> Styles) a sua regra aparece riscada (tachada), sinal de que outra regra do Astra Pro com mais especificidade venceu. - A sua regra nem aparece no código-fonte da página (Ctrl+U), indicando que o bloco do CSS Adicional não esta sendo impresso no head. - O CSS Adicional do Personalizar esta vazio depois que você trocou o tema ou ativou um tema filho, como se o código tivesse sumido. - Mensagem "Código CSS invalido não foi salvo" no rodape do CSS Adicional ao clicar em Publicar, apontando erro de sintaxe na regra. ## Como prevenir - Escreva regras de CSS Adicional sempre ancoradas em um container do Astra (por exemplo .ast-container) para vencer a especificidade do dynamic CSS do Astra Pro sem precisar de importante. - Antes de migrar para um tema filho, copie o conteúdo de Personalizar -> CSS Adicional, porque o código fica preso ao tema em que foi salvo. - Mantenha o bloco do CSS Adicional fora da minificacao e combinacao do plugin de cache desde a configuração inicial. - Depois de salvar uma regra no Personalizar, limpe o cache do plugin e do Cloudflare para garantir que o head publicado contenha a alteração. Erros relacionados - [Como corrigir o Customizer que não salva alterações no Astra Pro](https://full.services/wp-fixer/corrigir-customizer-nao-salva-astra-pro/) - [Como corrigir o erro de cores no Global Color Palette do Astra Pro](https://full.services/wp-fixer/corrigir-global-color-palette-astra-pro/) - [Como corrigir o conflito de CSS otimizado entre Astra Pro e WP Rocket](https://full.services/wp-fixer/corrigir-conflito-css-astra-pro-wp-rocket/) - [Como corrigir Spacing Controls que não aplicam no frontend no Astra Pro](https://full.services/wp-fixer/corrigir-spacing-controls-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-css-customizer-astra-pro/#article", "headline": "Como corrigir o erro de CSS no Customizer do Astra Pro", "url": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:06-03:00", "dateModified": "2026-06-17T12:39:06-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-css-customizer-astra-pro/" }, "wordCount": 906, "description": "O Astra Customizer CSS não aplica quando o código de Personalizar -> CSS Adicional não surte efeito no site, porque o cache serve o head antigo, a regra perde para a especificidade do CSS dinamico do Astra Pro, ou o CSS ficou preso a outro tema. A correção limpa o cache, sobe a especificidade do seletor e confirma o tema ativo.", "articleSection": "Page Builders", "keywords": "additional css astra nao surte efeito, astra css adicional nao carrega, astra customizer css personalizado nao aplica, astra pro additional css nao funciona, astra pro estilo do personalizar nao aparece", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://wpastra.com/docs/", "name": "Astra — Documentacao oficial" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o erro de CSS no Customizer do Astra Pro", "programmingLanguage": "CSS", "codeRepository": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q1", "name": "Por que o CSS aparece no preview do Personalizar mas não no site?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque o preview do Personalizar renderiza a regra na hora, no navegador, antes de gravar. No site publicado, o WordPress imprime o CSS Adicional no head pela função wp_custom_css_cb. Se o cache serve um head antigo ou o dynamic CSS do Astra Pro vence por especificidade, a regra existe mas não tem efeito visivel.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q2", "name": "Como sei se a minha regra perdeu por especificidade para o Astra Pro?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Abra a página, pressione F12, va em Elements e clique no elemento estilizado. Na aba Styles, se a sua regra aparece riscada (tachada), outra regra com mais especificidade venceu, geralmente o CSS dinamico do Astra Pro. A correção e tornar o seu seletor mais específico, prefixando com o body ou um container do tema.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q3", "name": "Por que o CSS Adicional sumiu depois que troquei de tema?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque o WordPress grava o CSS Adicional no tipo de post custom_css vinculado ao tema ativo. Ao trocar de tema ou ativar um tema filho, o código salvo no tema anterior deixa de ser carregado. Ele não foi apagado: basta voltar ao tema antigo para ve-lo, ou copiar a regra para o CSS Adicional do tema novo.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q4", "name": "Devo usar importante para forcar o CSS do Astra Pro a aceitar a regra?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Evite. O importante resolve no curto prazo mas vira uma guerra de importantes dificil de manter. O caminho correto e aumentar a especificidade do seletor, ancorando a regra em um container do Astra como o .ast-container ou prefixando com o body. Assim a sua regra vence o dynamic CSS sem abusar do importante.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q5", "name": "O cache pode impedir o CSS Adicional do Astra de aplicar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode, e e a causa mais comum. Plugins de cache e o Cloudflare guardam o HTML com o head antigo, antes de a regra ser impressa. Limpe o cache do plugin, da hospedagem e do Cloudflare, depois recarregue com Ctrl+Shift+R para ignorar o cache do navegador. Na maioria dos casos a regra aparece logo após isso.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q6", "name": "A minificacao de CSS do plugin de cache atrapalha o CSS Adicional?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. A minificacao e a combinacao de CSS as vezes removem ou reordenam o bloco inline do CSS Adicional, fazendo a regra carregar antes do dynamic CSS do Astra Pro e perder. Exclua o CSS Adicional da minificacao ou desligue a combinacao de CSS inline para o bloco do Personalizar voltar a vencer.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q7", "name": "Onde fica o CSS Adicional do Astra: no Customizer ou em outro lugar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O CSS de site inteiro fica em Aparencia -> Personalizar -> CSS Adicional, o campo nativo do WordPress que o Astra Pro respeita. Os Custom Layouts do Astra Pro também aceitam CSS, mas esse so se aplica onde a condicao de exibicao do layout casa. Se a regra deve valer no site todo, use o CSS Adicional do Personalizar, não o campo de um Custom Layout.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/#faq-q8", "name": "Preciso de FTP para corrigir o CSS Adicional do Astra Pro?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não na maioria dos casos. Limpar o cache, ajustar a especificidade do seletor e confirmar o tema ativo certo são feitos pelo painel e pelo inspetor do navegador. O FTP so entra se você precisar mover o CSS para o style.css do tema filho por organizacao, o que e opcional.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```