# Como corrigir o erro de cores no Global Color Palette do Astra Pro no WordPress

O Global Color Palette do Astra Pro não aplica quando o CSS dinâmico do tema fica preso em cache, quando a cor foi fixada manualmente no page builder ou em CSS adicional, ou quando um tema filho sobrescreve as variaveis de cor da paleta. Limpar o cache do Astra e remover os valores fixos restaura as cores em todo o site.

## O que é Global Color Palette do Astra Pro que não aplica?

O Global Color Palette do Astra Pro e a paleta central de cores do tema, definida no Personalizar do WordPress em Global e Cores, com os campos Cor 1 a Cor 9. Cada cor da paleta vira uma variavel CSS que o Astra reaproveita em títulos, links, botões, cabeçalho e rodape. A ideia e mudar a cor uma vez na paleta e ver a alteração refletir em todo o site sem editar página por página. O Astra gera esse CSS de forma dinâmica e o serve a partir de um arquivo em cache na pasta de uploads do site para não recalcular o estilo a cada visita.

O erro acontece quando você troca uma cor na paleta e o frontend continua exibindo a cor antiga, mistura cores novas e antigas, ou não reflete nada do que foi salvo. Na prática e quase sempre uma de três situacoes: o CSS dinâmico do Astra ou um plugin de cache ainda entrega o arquivo antigo, alguma cor foi gravada com valor fixo direto no page builder ou no CSS Adicional e ganha da paleta por especificidade, ou um tema filho redefine as mesmas variaveis. Identificar qual das três esta agindo e o que destrava a correção.

## Como identificar

- Você altera uma cor em Personalizar, Global, Cores e o frontend continua mostrando a cor antiga mesmo após salvar e recarregar.
- A previa do Personalizar mostra a cor nova, mas a página publicada exibe a cor antiga.
- Parte do site adota a cor nova da paleta e outra parte (botões, seções feitas no Elementor) mantem a cor antiga.
- A paleta volta sozinha para as cores padrão do Astra depois de uma atualização do tema ou do plugin Astra Pro.
- As cores da paleta aparecem corretas para administrador logado, mas erradas para visitante anonimo, indicando arquivo de CSS em cache servido ao público.

**Antes de começar:** Antes de editar o style.css do tema filho, mexer em CSS Adicional ou atualizar o tema e o Astra Pro em producao, faca um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso o layout ou as cores quebrem.

## Como prevenir

- Defina as cores do site apenas na Global Color Palette do Astra e referencie as cores Global no page builder, evitando gravar hexadecimais fixos em widgets e seções.
- Ao trocar uma cor da paleta, limpe sempre o cache do plugin de performance e da CDN logo depois, e valide em janela anonima.
- Mantenha o tema Astra e o plugin Astra Pro na mesma linha de versão estavel, atualizando os dois juntos após validar em staging.
- Documente no tema filho quais variaveis de cor são redefinidas, para não sobrescrever a paleta do Personalizar sem querer.
- Evite acumular regras de cor antigas em CSS Adicional e em plugins; revise periodicamente para que so a paleta do Astra controle as cores.

Erros relacionados

- [Como corrigir o erro de CSS no Customizer do Astra Pro](https://full.services/wp-fixer/corrigir-css-customizer-astra-pro/)
- [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 a incompatibilidade entre Astra Pro e Elementor Pro](https://full.services/wp-fixer/corrigir-conflito-astra-pro-elementor-pro/)

## Causa

- O CSS dinâmico do Astra ficou preso em cache: o tema grava o estilo da paleta em um arquivo na pasta wp-content/uploads/astra-addon (ou uploads/astra) e continua servindo a versão antiga até o cache do tema ser regenerado.
- Um plugin de cache de página ou de CSS (WP Rocket, LiteSpeed, W3 Total Cache) ou o cache da CDN ainda entrega o HTML e o CSS antigos com as cores anteriores ao visitante.
- A cor foi fixada com valor hexadecimal direto no widget ou seção do Elementor (ou de outro page builder) em vez de referenciar a Global do Astra, entao esse valor fixo vence a variavel da paleta por especificidade.
- Existe uma regra com a cor antiga no campo Personalizar, CSS Adicional, ou em um CSS de plugin, com seletor mais específico que o do Astra, sobrescrevendo a variavel da paleta no frontend.
- Um tema filho ativo redefine as variaveis CSS da paleta (por exemplo --ast-global-color-0) no próprio style.css, fazendo o site ignorar o valor escolhido no Personalizar.
- O Astra Pro ficou desatualizado ou com versão incompativel com o tema Astra, fazendo o painel da Global Color Palette não registrar ou não regravar o CSS dinâmico ao salvar.

## Como resolver

1. Confirme a cor salva na paleta e regenere o CSS do Astra: Va ao Personalizar e confirme que a Cor 1 a Cor 9 estão com os valores corretos e publicados. Em seguida force o Astra a recriar o arquivo de CSS dinâmico, que e onde a cor antiga costuma ficar presa, salvando o Personalizar de novo após limpar o cache do tema.

```
Painel WP -> Aparencia -> Personalizar -> Global -> Cores
Confira Cor 1 até Cor 9 e clique em Publicar
Astra ou Astra Pro: ao re-publicar, o arquivo de CSS dinâmico em wp-content/uploads/astra-addon e regravado
```

2. Limpe o cache de página, de CSS e da CDN: Mesmo com a paleta correta, um arquivo antigo em cache mantem a cor velha para o visitante. Limpe o cache do plugin de performance e o cache da CDN, e teste em uma janela anonima para ver o site como um visitante sem sessao.

```
Limpe o cache do plugin de performance (WP Rocket, LiteSpeed, W3 Total Cache)
Purgue o cache da CDN ou do Cloudflare, se houver
Abra o site em uma aba anonima e recarregue sem cache (Ctrl+Shift+R)
```

3. Remova cores fixas gravadas no page builder: Abra a seção ou o widget que ficou com a cor errada no Elementor ou no builder usado e troque o valor hexadecimal fixo pela referencia Global de cor, para que o elemento volte a obedecer a paleta do Astra em vez de uma cor presa no elemento.

```
Edite a página no page builder e abra o elemento com a cor errada
No seletor de cor, escolha a cor Global em vez de um hexadecimal fixo
Salve e atualize a página para aplicar a referencia da paleta
```

4. Procure overrides em CSS Adicional e em plugins: Verifique o campo Personalizar, CSS Adicional e o CSS de plugins por regras com a cor antiga e seletor mais específico que o do Astra. Remova ou ajuste essas regras para que a variavel da paleta prevaleca no frontend.

```
Painel WP -> Aparencia -> Personalizar -> CSS Adicional
Procure por valores de cor antigos (ex.: color: #aabbcc) e remova ou ajuste
Use Inspecionar (F12) no elemento errado para ver qual regra esta vencendo a variavel da paleta
```

5. Cheque o tema filho e atualize Astra e Astra Pro: Se um tema filho redefine as variaveis de cor da paleta, ajuste ou remova essa redefinicao no style.css do filho. Em seguida atualize o tema Astra e o plugin Astra Pro para as versões estaveis mais recentes, garantindo que o painel da paleta grave o CSS dinâmico corretamente.

```
Edite o style.css do tema filho e revise variaveis como --ast-global-color-0 até --ast-global-color-8
Painel WP -> Aparencia -> Temas -> atualize o Astra para a versão estavel mais recente
Painel WP -> Plugins -> atualize o Astra Pro (Astra Addon) para a versão compativel com o tema
```


## Código

```php
<?php
/**
 * Forca a regeneracao do CSS dinamico do Astra apos trocar cores na paleta.
 * Coloque em um plugin utilitario ou no functions.php do tema filho,
 * acesse o site uma vez logado como admin e depois remova o codigo.
 */
add_action( 'wp', 'full_astra_purge_dynamic_css' );
function full_astra_purge_dynamic_css() {
    if ( ! is_admin() && ! current_user_can( 'manage_options' ) ) {
        return;
    }
    // Astra (tema): limpa o cache do CSS dinamico do Customizer.
    if ( class_exists( 'Astra_Cache_Base' ) && method_exists( 'Astra_Cache_Base', 'refresh_assets' ) ) {
        Astra_Cache_Base::refresh_assets( 'astra' );
    }
    // Astra Pro (addon): limpa o cache do CSS dinamico do addon.
    if ( class_exists( 'Astra_Cache_Base' ) ) {
        Astra_Cache_Base::refresh_assets( 'astra-addon' );
    }
}
```

## Perguntas frequentes

### Por que mudei a cor na Global Color Palette do Astra e o site não atualizou

Quase sempre e cache. O Astra grava o estilo da paleta em um arquivo de CSS dinâmico na pasta de uploads e plugins de cache ou a CDN podem servir a versão antiga. Re-publique o Personalizar, limpe o cache do plugin de performance e da CDN e teste em uma janela anonima.

### Onde fica a Global Color Palette no Astra

No Personalizar do WordPress, em Global e depois Cores. La você define a Cor 1 até a Cor 9 da paleta, que o tema reaproveita em títulos, links, botões e demais elementos do site por meio de variaveis CSS.

### Por que so uma parte do site pegou a cor nova da paleta

Provavelmente aquela seção tem a cor gravada com valor fixo no page builder ou em CSS adicional, o que vence a variavel da paleta por especificidade. Abra o elemento no builder e troque o hexadecimal fixo pela cor Global do Astra.

### A paleta funciona no Astra grátis ou so no Astra Pro

A Global Color Palette faz parte do tema Astra e do Astra Pro. O Astra Pro adiciona opções extras de personalização, mas o conjunto de cores Global e o comportamento de variaveis CSS valem para a base do tema; mantenha tema e addon atualizados juntos.

### Como sei se o problema e cache ou cor fixa no elemento

Use Inspecionar (F12) no elemento com a cor errada e veja qual regra esta vencendo. Se a regra usa a variavel da paleta mas mostra valor antigo, e cache; se ha um hexadecimal fixo no seletor do elemento, a cor foi presa no builder ou em CSS adicional.

### Atualizei o Astra e a paleta voltou para as cores padrão

Isso costuma indicar incompatibilidade de versão entre o tema Astra e o plugin Astra Pro, ou um CSS dinâmico desatualizado. Atualize tema e addon para versões compativeis, re-publique o Personalizar e limpe o cache para o tema regravar o estilo da paleta.

### Preciso editar código para corrigir a paleta de cores do Astra

Na maioria dos casos não. A correção se resolve no Personalizar, limpando cache e removendo cores fixas no builder. Código so e necessário quando um tema filho redefine as variaveis da paleta no style.css e você precisa ajustar essa redefinicao.

### Limpar o cache apaga as configurações da minha paleta de cores

Não. Limpar cache apenas descarta os arquivos de CSS e HTML antigos para o tema regerar o estilo atual; as cores da paleta ficam salvas no banco de dados pelo Personalizar e são reaplicadas no próximo carregamento.

**Fonte:** [Astra Theme - Documentacao oficial (Global Colors e Customizer)](https://wpastra.com/docs/)