Options Page ACF Não Salva: como corrigir o erro

Tipo Page Builders

Nome do erro Options Page do ACF PRO não salva EN: ACF PRO Options Page not saving

Severidade Grave

Descrição A Options Page do ACF PRO que não salva acontece quando você clica em Update e os valores voltam vazios, quase sempre porque a página foi registrada com um post_id diferente do que o get_field lê, a capability barra a gravação ou o field group não tem a location rule de Options Page.

Conteúdo exclusivo para membros Pro

Faça upgrade para acessar este item completo.

// ★ Conteúdo disponível para membros Pro...
// Faça upgrade para acessar este item.

Perguntas frequentes

Por que a Options Page do ACF mostra Options Updated mas não salva?

A mensagem verde confirma que o POST chegou, não que o valor foi lido de volta. Quase sempre o post_id do registro difere do post_id da leitura, então o ACF grava em um registro de wp_options e o tema busca de outro. Alinhe os dois identificadores.

Devo usar option ou um post_id customizado na Options Page?

Os dois funcionam, desde que registro e leitura usem o mesmo. Se você manteve o padrão, leia com get_field('campo', 'option'). Se definiu post_id no acf_add_options_page(), use exatamente esse valor na leitura, senão o campo volta vazio.

A capability pode impedir o save da Options Page?

Sim. Se a capability do registro for maior que a do usuário, ele vê a tela mas o WordPress recusa o POST de Update. O padrão é edit_posts; para telas só de administrador use manage_options e confirme que o usuário tem esse papel.

Por que duas Options Pages mostram os mesmos valores?

Elas compartilham o mesmo field group sem post_id próprio, então os valores sincronizam entre as telas. Crie um field group separado por página ou defina post_id distinto em cada acf_add_options_page() para isolar os dados.

Preciso registrar a Options Page dentro de algum hook?

Sim. Chame acf_add_options_page() dentro do hook acf/init e antes do admin_menu na prioridade 99. No WordPress 6.8 ou superior, registrar fora desse hook gera notice de tradução precoce e a página pode não registrar.

O valor salva no banco mas a tela continua vazia, o que é?

Um cache de objeto persistente, como Redis ou Memcached, está servindo a versão antiga de wp_options. Rode wp cache flush e recarregue. Se persistir, confira se o autoload do valor está coerente com o uso da página.

A location rule do field group afeta o salvamento?

Afeta. Se a regra de localização não aponta para a Options Page, os campos aparecem mas não ficam vinculados ao save daquela tela. Em Custom Fields, abra o grupo e ajuste a regra para Options Page is equal to a sua página.

Pro Grave

Como corrigir o erro ‘Template Not Found’ no Elementor

O erro "Template Not Found" do Elementor surge quando o site tenta carregar um template salvo que não existe mais no banco ou que veio de outro domínio. É comum após migração ou clonagem sem rodar o Replace URL, ou quando o template referenciado foi excluído da biblioteca.

Pro Atenção

Como corrigir o Image Field no ACF PRO

O Image Field do ACF PRO não retorna a URL quando o Return Format do campo está como Image Array ou Image ID, mas o template usa o valor como se fosse a string da URL. O ACF devolve um array ou um número de anexo, então o atributo src da imagem sai quebrado ou vazio.

Pro Grave

Como corrigir erros de JavaScript no console ao usar o Elementor

O erro de JavaScript no console do Elementor aparece como mensagens Uncaught no DevTools do navegador (F12) e impede o editor de carregar ou quebra widgets no frontend. A causa quase sempre e outro plugin que duplica ou remove o jQuery, ou um plugin de cache que minifica e combina os arquivos JS do Elementor na ordem errada.

Pro Grave

Como corrigir o erro de Dynamic Content do ACF PRO no Elementor

O Dynamic Content do ACF no Elementor falha quando o campo não surge na lista de Dynamic Tags ou renderiza vazio no widget. As causas reais são ausência do Elementor PRO, tipo não suportado como Repeater, meta key divergente ou Location Rules fora do template. A correção alinha a fonte ACF Field ou usa Post Custom Field.

Pro Grave

Como corrigir o JetSmartFilters AJAX que não retorna resultados

O JetSmartFilters AJAX que não retorna resultados aplica o filtro, dispara a chamada ao admin-ajax.php, mas o Listing Grid volta vazio ou sem mudar. A causa quase sempre e o Query ID do filtro diferente do provider, o indexer não gerado, ou o cache servindo a página antiga.

Pro Grave

Como corrigir conflitos entre o Elementor e plugins de cache

O conflito entre Elementor e cache acontece quando um plugin de cache serve CSS, HTML ou JavaScript antigos, deixando o layout quebrado no frontend ou travando o editor. A correção envolve regenerar o CSS do Elementor, excluir o editor da otimização e limpar o cache na ordem certa.

Setores

Extensões

Integrações

Como corrigir a Options Page que não salva no ACF PRO

Conteúdo exclusivo para membros Pro

Perguntas frequentes

Itens relacionados

Como corrigir o erro ‘Template Not Found’ no Elementor

Como corrigir o Image Field no ACF PRO

Como corrigir erros de JavaScript no console ao usar o Elementor

Como corrigir o erro de Dynamic Content do ACF PRO no Elementor

Como corrigir o JetSmartFilters AJAX que não retorna resultados

Como corrigir conflitos entre o Elementor e plugins de cache

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