Dynamic Tags ACF Elementor não exibe: como corrigir

Tipo Page Builders

Nome do erro Dynamic Tags do Elementor não exibem dados do ACF EN: Elementor Dynamic Tags not displaying ACF data

Severidade Grave

Descrição As Dynamic Tags do Elementor deixam de exibir dados do ACF quando o campo sai vazio no widget dinamico do editor. As causas reais são o Elementor Pro inativo (Dynamic Tags e recurso Pro), a regra de local do grupo ACF não casar com o post editado, ou o Image Field retornar Array em vez de Image URL.

O que é Dynamic Tags do Elementor que não exibem dados do ACF?

A Dynamic Tag ACF Field do Elementor Pro e a ponte que injeta o valor de um campo do Advanced Custom Fields dentro de um widget do Elementor (titulo, texto, imagem, botao), sem escrever código no tema. Você clica no icone de conteúdo dinamico do widget, escolhe a tag ACF Field e seleciona a chave do campo; o Elementor le aquele campo do post atual e renderiza o valor. Quando essa ligacao falha, o widget continua no layout mas sai vazio no editor e no frontend, porque o Elementor recebeu uma string vazia do ACF. O problema quase nunca e o widget: e o contexto entre o grupo de campos ACF, o post que esta sendo editado e o formato de retorno do campo.

Como identificar

Ao clicar no icone de conteúdo dinamico do widget, a opção ACF Field nem aparece na lista de Dynamic Tags do Elementor.
A Dynamic Tag ACF Field aparece, você seleciona o campo, mas o widget fica em branco no editor e no frontend.
Um campo ACF de imagem mostra um icone de imagem quebrada ou nada, mesmo com a imagem preenchida no painel do post.
O campo funciona numa página comum, mas some quando usado dentro de um Theme Builder (Single ou Archive) do Elementor.
Os valores do ACF aparecem certos no frontend via the_field no tema, mas continuam vazios quando puxados pela Dynamic Tag do Elementor.

Como prevenir

Defina o Return Format dos campos de imagem como Image URL e dos campos de link como Link URL desde a criação do campo, antes de usar no Elementor
Crie a regra de local do grupo de campos ACF apontando para o mesmo tipo de post dos templates do Theme Builder que vao consumir o campo
Mantenha o Elementor Pro com licenca ativa e teste a Dynamic Tag num post de exemplo preenchido antes de publicar o template

Causa

Elementor Pro inativo ou licenca expirada: a funcionalidade Dynamic Tags so existe no Elementor Pro, entao no Elementor gratuito a tag ACF Field nunca aparece na lista de conteúdo dinamico.
Regra de local (Location Rules) do grupo de campos ACF não casa com o tipo de post editado: o grupo esta restrito a Post Type igual a post e você edita uma page ou um template, entao o campo não existe para aquele conteúdo e a Dynamic Tag retorna vazio.
Image Field do ACF configurado com Return Format igual a Image Array ou Image ID: o widget Image do Elementor espera uma URL, recebe um array ou um número e não consegue renderizar a imagem.
Campo ACF sem valor salvo para o post específico que esta em edição: o grupo de campos casa, mas aquele post nunca teve o campo preenchido, entao o ACF devolve string vazia para a Dynamic Tag.
Edição de um Theme Builder Single ou Archive em que a previa do Elementor aponta para um post sem o campo, ou o grupo de campos não esta atribuido ao mesmo tipo de post do template, fazendo o valor sumir so dentro do template.
Campo criado numa Options Page do ACF e referenciado como campo de post comum: a Dynamic Tag ACF Field le o contexto do post atual e não a tabela de opções, retornando vazio.

Como resolver

Confirme que o Elementor Pro esta ativo e licenciado: as Dynamic Tags são um recurso exclusivo do Elementor Pro. Verifique se o Pro esta instalado, ativado e com a licenca valida, porque so assim o icone de conteúdo dinamico oferece a tag ACF Field no widget.
```
WP Admin -> Plugins -> confirmar Elementor Pro ativado
WP Admin -> Elementor -> Licença -> status Conectado/Ativo
```
Ajuste a regra de local do grupo de campos ACF: abra o grupo de campos no ACF e confira em Configurações de Local se a regra inclui o tipo de post (ou o template) que você esta editando no Elementor. Se a regra exigir um Post Type que não bate com o conteúdo atual, o campo nunca chega até a Dynamic Tag.
```
WP Admin -> ACF -> Grupos de campos -> abrir o grupo
Configurações -> Local -> Mostrar este grupo de campos se: Tipo de post é igual a (post/page do template)
```
Corrija o Return Format do campo de imagem ou link: em campos de imagem, defina o formato de retorno como Image URL para o widget Image do Elementor conseguir renderizar; campos de imagem que retornam Array ou ID não são aceitos pela Dynamic Tag de imagem. Para links, use o formato Link URL.
```
WP Admin -> ACF -> Grupos de campos -> editar o campo de Imagem
Formato de Retorno -> Image URL
Campos de Link -> Formato de Retorno -> Link URL
```
Reselecione a Dynamic Tag e confirme o valor do campo: no widget, clique no icone de conteúdo dinamico, escolha ACF Field e selecione de novo a chave correta do campo, depois confira no painel do post que aquele campo realmente tem valor salvo. Campo vazio no post devolve vazio para a tag.
```
Selecione o widget -> icone de conteúdo dinâmico (cilindro) -> ACF Field -> escolher o campo
Editar o post -> preencher o campo ACF -> Atualizar
```
Ajuste a previa do Theme Builder e regenere o CSS: se o problema so ocorre dentro de um template do Theme Builder, defina a Preview Settings do template para um post que tenha o campo preenchido e garanta que o grupo de campos esta atribuido ao tipo de post do template. Em seguida, regenere os arquivos do Elementor para limpar valores em cache.
```
Editor do template -> Configurações de Pré-visualização -> apontar para um post com o campo preenchido
WP Admin -> Elementor -> Ferramentas -> Regenerar Arquivos e Dados
```

PHP

// functions.php do tema-filho — registra uma Dynamic Tag de fallback que entrega
// SEMPRE a URL de um campo de imagem do ACF, mesmo quando o Return Format esta como Array/ID.
// Util quando voce nao pode mudar o Return Format de campos ja em producao.
add_filter( 'acf/format_value/type=image', function ( $value, $post_id, $field ) {
    if ( is_array( $value ) && ! empty( $value['url'] ) ) {
        return $value['url']; // entrega a URL que o widget Image do Elementor espera
    }
    if ( is_numeric( $value ) ) {
        return wp_get_attachment_url( $value ); // converte o ID em URL
    }
    return $value;
}, 20, 3 );

// Diagnostico rapido: confirme se o campo tem valor para o post atual.
// Troque 'meu_campo' pela chave real e veja o retorno no log de debug.
add_action( 'wp_footer', function () {
    if ( is_singular() && current_user_can( 'manage_options' ) ) {
        error_log( 'ACF meu_campo = ' . var_export( get_field( 'meu_campo', get_the_ID() ), true ) );
    }
} );

Perguntas frequentes

Por que a opção ACF Field nem aparece nas Dynamic Tags do Elementor

Porque Dynamic Tags e um recurso exclusivo do Elementor Pro. No Elementor gratuito o icone de conteúdo dinamico não oferece a tag ACF Field. Confirme que o Elementor Pro esta instalado, ativado e com a licenca valida em Elementor -> Licença, e que o ACF também esta ativo.

Selecionei o campo ACF na Dynamic Tag, mas o widget continua vazio. O que fazer

Quase sempre o campo não tem valor salvo para aquele post, ou o grupo de campos esta restrito a um tipo de post diferente do que você edita. Abra o post e preencha o campo, e confira nas Configurações de Local do grupo de campos se a regra inclui o tipo de post atual.

Meu campo de imagem do ACF não carrega no widget Image do Elementor. Por que

O widget Image do Elementor espera uma URL, mas o campo de imagem do ACF provavelmente esta com o Return Format em Image Array ou Image ID. Edite o campo no ACF e mude o Formato de Retorno para Image URL; depois reselecione a Dynamic Tag no widget.

O campo ACF funciona na página, mas some dentro do Theme Builder. Por que

Dentro de um template Single ou Archive a previa do Elementor pode apontar para um post sem o campo preenchido, ou o grupo de campos não esta atribuido ao tipo de post do template. Ajuste as Configurações de Pre-visualizacao do template para um post com valor e inclua o tipo de post na regra de local do grupo.

Preciso do ACF PRO para usar Dynamic Tags no Elementor

Não para campos basicos. O Elementor Pro le campos do ACF gratuito e do ACF PRO pela tag ACF Field. O que e obrigatório e o Elementor Pro, porque as Dynamic Tags não existem na versão gratuita do Elementor.

O valor aparece com the_field no tema, mas vazio na Dynamic Tag. O que muda

A função the_field le o contexto que o tema define, enquanto a Dynamic Tag le o post atual do Elementor. Se o template aponta para outro post, ou o campo esta numa Options Page, a tag retorna vazio. Confirme o post da previa e, para opções, use a fonte correta da Dynamic Tag em vez de tratar como campo de post.

Mudei o Return Format e mesmo assim não aparece. Falta algo

Depois de alterar o Formato de Retorno, reselecione a Dynamic Tag no widget para ela recarregar o novo formato, e regenere os arquivos em Elementor -> Ferramentas -> Regenerar Arquivos e Dados. Valores antigos podem ficar em cache no CSS do Elementor.

Tenho campo Repeater ou Group do ACF. A Dynamic Tag exibe direto

A Dynamic Tag ACF Field exibe campos simples como texto, número, imagem e link. Campos estruturados como Repeater, Group e Flexible Content não saem direto pela tag e geralmente precisam de um loop ou widget próprio. Para esses casos, use um campo simples dentro do contexto ou um plugin de loop compativel.

Atenção

Como corrigir o layout quebrado de páginas de curso entre Tutor LMS e Astra Pro no WordPress

O layout quebrado entre Tutor LMS e Astra na página de curso ocorre quando o template de single course do Tutor entra em conflito com o container, a sidebar ou a largura de conteúdo definidos pelo tema Astra, deixando a página desalinhada, com sidebar indevida ou sobreposta ao cabeçalho.

Atenção

Como corrigir o Gallery Field do ACF PRO quando o lightbox não funciona

O lightbox do Gallery Field do ACF PRO não funciona porque o ACF não inclui lightbox próprio: ele só entrega os dados das imagens, e o efeito de ampliar ao clicar depende de o seu template renderizar o link para a imagem cheia com o atributo que a biblioteca de lightbox do tema ou plugin reconhece.

Informativo

Como corrigir o layout responsivo do widget Card no Happy Addons

O layout responsivo do widget Card do Happy Addons quebra quando a largura da coluna, o tamanho da imagem ou o alinhamento do texto não são ajustados por dispositivo no Elementor, fazendo o card desalinhar, estourar a imagem ou perder a altura igual no celular e no tablet.

Atenção

Como corrigir a incompatibilidade de templates entre Crocoblock e Astra Pro

A incompatibilidade de templates entre Crocoblock e Astra Pro acontece quando o JetThemeCore aplica um Body Template na mesma condicao em que o Astra Pro já monta cabeçalho, título e container, e os dois layouts competem. O resultado e cabeçalho duplicado, título repetido ou o template errado vencendo.

Atenção

Como corrigir o Elementor Kit que não importa corretamente

Quando um Kit do Elementor não importa corretamente, a importação trava no meio, retorna template inválido ou conclui sem trazer páginas e conteúdo. As causas reais são timeout pelo tamanho do kit, limites de PHP no upload e plugins de dependência ausentes.

Atenção

Como corrigir o Sticky Header que não funciona no Safari no Astra Pro

O Astra sticky header não funciona no Safari quando o módulo Sticky Header do Astra Pro não está ativo para o dispositivo, quando um ancestral do cabeçalho usa overflow ou transform que invalida o position sticky no WebKit, ou quando CSS e cache antigos do tema continuam sendo servidos ao navegador da Apple.

Setores

Extensões

Integrações

Como corrigir Dynamic Tags do Elementor que não exibem dados do ACF

O que é Dynamic Tags do Elementor que não exibem dados do ACF?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o layout quebrado de páginas de curso entre Tutor LMS e Astra Pro no WordPress

Como corrigir o Gallery Field do ACF PRO quando o lightbox não funciona

Como corrigir o layout responsivo do widget Card no Happy Addons

Como corrigir a incompatibilidade de templates entre Crocoblock e Astra Pro

Como corrigir o Elementor Kit que não importa corretamente

Como corrigir o Sticky Header que não funciona no Safari no Astra 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