Custom Fields Não Aparecem no Frontend (ACF): correção

Tipo Page Builders

Nome do erro Custom Fields do ACF PRO não aparecem no frontend EN: ACF PRO custom fields not showing on frontend

Severidade Grave

Descrição Custom fields do ACF PRO que não aparecem no frontend acontecem quando get_field() ou the_field() retorna vazio porque o field group não cobre o post atual, o post_id passado está errado ou o return format não bate com o que o template tenta imprimir.

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 get_field() retorna vazio se o campo está preenchido?

Quase sempre é contexto: a chamada roda fora do The Loop ou em outro post, então o post_id padrão não é o dono do valor. Passe o ID correto no segundo parâmetro ou confira as Location Rules do field group.

Qual a diferença entre get_field() e the_field() para exibir o campo?

get_field() retorna o valor para você usar no PHP, e the_field() já imprime na tela, equivalente a echo get_field(). Para campos WYSIWYG, the_field() é preferível porque aplica os filtros de formatação do conteúdo.

Meu campo de imagem mostra um número em vez da foto, o que é?

O campo está com Return Format igual a ID ou Array. Troque para URL na configuração do campo, ou acesse a chave url do array no template antes de imprimir com esc_url().

Os campos sumiram depois que migrei o site, como recupero?

Os valores continuam no banco, mas o field group não está registrado em produção. Abra Custom Fields -> Field Groups e use Sync available para importar os grupos do acf-json, ou recrie a regra de localização.

Preciso usar field name ou field key na chamada?

Use o field name (ex.: subtitulo) nas chamadas do tema. O field key (field_xxxxxxxx) só resolve com o grupo registrado e serve para registro de campos via PHP, não para leitura no template.

Como exibo um campo de uma Options Page do ACF PRO?

Passe a string option como segundo parâmetro: get_field('telefone', 'option'). Sem isso o ACF procura o valor no post atual e devolve vazio, porque a Options Page não é um post.

Por que o campo aparece no editor mas não no frontend?

O editor lê o valor direto pelo field key, mas o frontend depende do field group estar registrado e da chamada estar no contexto certo. Verifique Location Rules, post_id e se o Local JSON foi sincronizado.

Pro Grave

Como corrigir o conflito de templates de curso entre Tutor LMS e Elementor

A página de curso fica sem o layout do Elementor (ou mostra o template padrão do Tutor LMS) porque o addon Tutor LMS do Elementor não esta ativo ou a prioridade de template aponta para o template embutido do plugin em vez do seu template Elementor.

Pro Atenção

Como corrigir Elementor com widgets que não aparecem

O Elementor com widgets que nao aparecem mostra o painel lateral vazio ou sem os widgets esperados, e elementos somem da pagina ao editar. A causa quase sempre e o JavaScript do editor bloqueado por minificacao ou cache, o Elementor PRO inativo (escondendo os widgets PRO), ou memoria PHP insuficiente impedindo o painel de montar a lista.

Pro Grave

Como corrigir erros de compatibilidade entre o Elementor e o PHP 8.3

O erro de compatibilidade do Elementor com o PHP 8.3 acontece quando uma versão antiga do plugin roda num servidor já no PHP 8.3, disparando avisos de deprecated ou um fatal error que derruba o editor ou o front-end. A correção é alinhar o Elementor e o Elementor Pro na última versão e garantir os recursos de PHP exigidos.

Pro Atenção

Como corrigir o Page Title que não oculta no Astra Pro com Elementor

No Astra com Elementor, o titulo da página não oculta quando a opção por página e sobrescrita por um ajuste global do Personalizar, quando o template do Elementor não e o esperado, ou quando o CSS antigo em cache continua exibindo o cabeçalho. A visibilidade do titulo no Astra e definida em camadas, e a camada errada vence.

Pro Grave

Como corrigir o erro “Preview Could Not Be Loaded” no Elementor

O erro "Preview Could Not Be Loaded" aparece quando o editor do Elementor não consegue carregar a página dentro do iframe de preview. O próprio aviso costuma apontar a causa: tema ausente, .htaccess corrompido, código HTTP de erro ou a página de posts definida como página estática.

Pro Grave

Como corrigir o Flexible Content que não salva layouts no ACF PRO

O Flexible Content que não salva no ACF PRO acontece quando os layouts e seus subcampos viram tantos campos no formulário que o POST ultrapassa o limite max_input_vars do PHP: o WordPress descarta o excedente, o nonce ou os dados não chegam e a atualização do post perde os layouts. A correção é elevar max_input_vars para 10000.

Setores

Extensões

Integrações

Como corrigir Custom Fields que não aparecem no frontend no ACF PRO

Conteúdo exclusivo para membros Pro

Perguntas frequentes

Itens relacionados

Como corrigir o conflito de templates de curso entre Tutor LMS e Elementor

Como corrigir Elementor com widgets que não aparecem

Como corrigir erros de compatibilidade entre o Elementor e o PHP 8.3

Como corrigir o Page Title que não oculta no Astra Pro com Elementor

Como corrigir o erro “Preview Could Not Be Loaded” no Elementor

Como corrigir o Flexible Content que não salva layouts no ACF PRO

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