Criar um widget customizado no Elementor com o ACF PRO é montar blocos que puxam dados de campos personalizados em vez de texto fixo, usando as Dynamic Tags do Elementor Pro como ponte entre o ACF e o construtor. O ACF guarda os campos, e o Elementor exibe cada valor onde você quiser na página. O resultado é um widget que se atualiza sozinho quando o conteúdo muda, sem você reabrir o editor. Este guia faz parte do hub de Elementor Pro da FULL e mostra o passo a passo real, do grupo de campos à Dynamic Tag conectada.

O que é um widget dinâmico com campos do ACF PRO

Um widget dinâmico com campos do ACF PRO é um elemento do Elementor cujo conteúdo vem de um campo personalizado em vez de texto digitado na mão: a Dynamic Tag do Elementor Pro lê o valor do ACF e o exibe no widget. O ACF entrega o dado, e o Elementor entrega o lugar e o estilo.

Na prática, você cria um grupo de campos no ACF PRO, preenche o valor em cada post e, no Elementor, troca o conteúdo estático do widget por uma Dynamic Tag apontada para esse campo. Assim, um único layout serve a centenas de posts, cada um com o seu dado. Nos atendimentos da FULL sobre Elementor Pro, o tropeço campeão é digitar o texto direto no widget e não perceber que ele deixou de ser dinâmico, o que obriga a editar cada página na mão quando o conteúdo muda.

Legenda: a Dynamic Tag lê o campo do ACF e o exibe no widget do Elementor.

Quando vale usar campos ACF em vez de texto fixo no widget

Vale usar campos ACF quando o mesmo layout se repete em vários posts com dados diferentes, quando o cliente precisa editar valores sem mexer no Elementor ou quando você monta um template único para um tipo de conteúdo, e vale o texto fixo quando o conteúdo é único de uma página só. O campo dinâmico rende quando há repetição de estrutura com variação de dado.

Use este teste antes de montar. Diga SIM aos campos ACF se você tem dez, cem ou mil posts que compartilham o mesmo formato, como fichas de produto, perfis ou imóveis, e cada um muda só os valores. Diga NÃO se a página é única e o conteúdo nunca se repete, porque aí o texto fixo é mais simples. O encaixe ideal é o template de um tipo de conteúdo com muitos itens. Para montar a página onde esses widgets vivem, o guia de como criar um site com Elementor Pro dá a base do construtor.

Pré-requisitos antes de criar o widget

Antes de criar o widget dinâmico você precisa de três peças no lugar, o Elementor Pro ativo, porque as Dynamic Tags são um recurso exclusivo da versão paga, o ACF PRO instalado, e um tipo de conteúdo com os campos a exibir, e a falta de qualquer uma quebra a ponte entre o campo e o widget. Sem o Elementor Pro, a opção de Dynamic Tag nem aparece no widget.

Checklist de prontidão antes de começar:

• Elementor Pro ativo, que habilita as Dynamic Tags nos widgets.
• ACF PRO instalado e ativado, com a licença válida.
• Um grupo de campos planejado para o tipo de conteúdo.
• Um post de teste com os campos já preenchidos.
• A definição de quais widgets vão receber dados dinâmicos.
• Permissão de administrador para criar grupos de campos e templates.
• Backup do site antes de aplicar o template ao conteúdo.

Pense no conjunto como uma planilha ligada a um relatório: o ACF é a planilha onde cada linha guarda os valores, o Elementor é o relatório formatado, e a Dynamic Tag é a fórmula que traz cada célula para o lugar certo. Sem a fórmula, o relatório fica com campos vazios esperando o preenchimento manual.

Como criar o widget customizado em 5 passos

Criar o widget customizado segue cinco passos, do grupo de campos à Dynamic Tag conectada, e respeitar a ordem evita o erro mais comum: digitar o conteúdo no widget e esquecer de torná-lo dinâmico. Cada passo liga uma ponta, do dado à exibição. Confirme antes que o Elementor Pro e o ACF PRO estão ativos, porque a Dynamic Tag depende dos dois juntos.

Passo 1: Crie o grupo de campos no ACF PRO

No ACF PRO, crie um grupo de campos para o tipo de conteúdo que vai receber dados dinâmicos, definindo cada campo com o nome, o tipo e o rótulo que fazem sentido, porque é esse grupo que o Elementor vai ler depois. Escolha o tipo certo, texto, imagem, número ou seleção, conforme o dado, seguindo a referência dos plugins do WordPress. Anote o nome do campo, porque é por ele que a Dynamic Tag vai encontrar o valor. Esse grupo é a fundação do widget dinâmico: sem campos bem definidos, não há o que exibir, então planeje a estrutura antes de abrir o construtor.

Passo 2: Defina as regras de exibição do grupo

Configure as regras de localização do grupo de campos para que ele apareça só no tipo de conteúdo certo, um post, uma página ou um Custom Post Type, porque é isso que faz os campos surgirem no editor onde você preenche os valores. Sem a regra de localização correta, o grupo fica salvo mas invisível no post, e você não tem onde digitar o dado. Abra um post do tipo escolhido e confirme que os campos do ACF aparecem na tela de edição. Preencha um valor de teste em cada campo, porque o widget só vai mostrar algo se houver dado preenchido para a Dynamic Tag puxar.

Passo 3: Adicione o widget no Elementor

No Elementor Pro, abra o template ou a página e arraste o widget que vai receber o dado, um título, um texto, uma imagem ou um botão, posicionando-o onde o valor deve aparecer, porque o widget é o recipiente que a Dynamic Tag vai preencher. Monte o layout completo com os widgets estáticos e dinâmicos misturados, deixando claro quais blocos virão do ACF. Estilize o widget normalmente, com fonte, cor e espaçamento, já que o estilo é seu e o conteúdo é que será dinâmico. Salve o progresso antes de conectar a tag, mantendo o desenho da página pronto para receber os dados reais.

Passo 4: Conecte a dynamic tag ao campo do ACF

No widget, clique no ícone de Dynamic Tags ao lado do campo de conteúdo e escolha a opção ACF, apontando para o campo exato criado no passo 1, porque é essa conexão que transforma o widget estático em dinâmico. Esse é o passo que mais gente esquece, deixando o texto fixo no lugar do campo. Selecione o grupo e o campo corretos na lista. Se a Dynamic Tag não traz o valor do ACF, veja como corrigir o erro de Dynamic Content do ACF no Elementor, que costuma ser um conflito de nome ou de tipo de campo entre os dois plugins.

Passo 5: Teste com conteúdo real

Abra o post de teste no front-end e confirme que o widget exibe o valor preenchido no ACF, porque só o conteúdo real prova que a ponte entre campo e widget funciona. Edite o valor no post e recarregue a página para ver o widget atualizar sozinho, sem tocar no Elementor. Verifique também no celular, já que o layout dinâmico precisa responder bem no mobile. Se um campo do tipo Flexible Content não renderiza no widget, veja como corrigir o Flexible Content do ACF que não aparece no Elementor antes de aplicar o template a todo o conteúdo.

Legenda: cada passo liga uma ponta, do grupo de campos à Dynamic Tag testada.

Erros comuns ao exibir campos ACF no Elementor

Os três erros mais comuns ao exibir campos ACF no Elementor são digitar o conteúdo no widget em vez de conectar a Dynamic Tag, apontar a tag para o campo errado e esquecer de preencher o valor no post. O primeiro é o mais frequente: o widget fica pronto e parece dinâmico, mas o texto está fixo, e mudar o campo no ACF não muda nada na página.

O segundo erro é escolher o campo errado na lista da Dynamic Tag, em geral por nomes parecidos entre grupos, o que faz o widget mostrar um dado que não era o esperado. A correção é conferir o nome exato do campo no ACF. O terceiro caso é o widget vazio porque o post não tem o campo preenchido, então a tag não encontra valor para exibir. Quando o conteúdo dinâmico simplesmente não aparece após conectar a tag, vale ver como corrigir o Dynamic Content do ACF no Elementor, que cobre os conflitos mais comuns entre os dois plugins.

Como manter os widgets dinâmicos em produção

Manter os widgets dinâmicos em produção exige cuidar de duas frentes, a integridade dos nomes de campo e a compatibilidade entre o ACF e o Elementor a cada atualização, porque renomear um campo no ACF quebra a Dynamic Tag que apontava para ele e uma atualização pode mudar como a conexão se comporta. O template dinâmico serve muitos posts, então um campo quebrado afeta o site inteiro de uma vez.

Evite renomear campos do ACF depois que as Dynamic Tags já apontam para eles, porque a tag busca pelo nome e perde o valor se ele mudar. Depois de cada atualização do ACF PRO ou do Elementor Pro, abra um post de teste e confirme que os widgets dinâmicos ainda trazem os valores certos. Para expandir o template com filtros e buscas sobre esses campos, o guia de sistemas de filtros no Elementor mostra como organizar grandes volumes de conteúdo dinâmico.

Como a FULL faz isso em escala

A FULL padroniza a montagem de widgets dinâmicos com ACF e Elementor porque acompanha mais de 150 mil sites WordPress, e templates de produto, imóvel ou perfil aparecem o tempo todo, onde refazer a conexão campo a campo em cada projeto vira gargalo. Em vez de licença avulsa do Elementor Pro por instalação, a ferramenta entra no bundle e o padrão de widget dinâmico fica replicável de um site para outro.

No plano PRO da FULL, por R$849, o Elementor Pro já vem no pacote para até dez sites, o que dá R$85 por site em vez de pagar cada licença separada. Para quem monta vários templates de conteúdo, a gente vê isso trocar um custo recorrente espalhado por um padrão único: o mesmo grupo de campos e o mesmo template com Dynamic Tags são exportados e reaproveitados de um projeto para outro, sem refazer a ponte do zero a cada site. É a economia que só aparece quando o stack é o mesmo em toda a base.

Checklist final do widget dinâmico

O checklist final do widget dinâmico confirma, em uma passada, que o conteúdo vem do campo e se atualiza sozinho antes de você aplicar o template a todo o conteúdo. Rode esta lista depois do passo 5 e a cada atualização grande do ACF ou do Elementor, porque é nessas atualizações que uma conexão dinâmica costuma se romper.

Antes de declarar pronto, confirme:

• O grupo de campos está salvo e com as regras de exibição corretas.
• Os campos aparecem no editor do post e aceitam valores.
• O widget no Elementor está com a Dynamic Tag conectada, não com texto fixo.
• A tag aponta para o campo exato, conferido pelo nome no ACF.
• O post de teste exibe o valor real no front-end.
• Editar o campo no post atualiza o widget sem reabrir o Elementor.
• O layout dinâmico funciona bem no celular, não só no desktop.

Se qualquer item falhar, principalmente a conexão da Dynamic Tag, volte ao passo correspondente antes de aplicar o template ao conteúdo real.

Perguntas frequentes sobre widget customizado no Elementor com o ACF PRO

Próximos passos para templates que se atualizam sozinhos

Criar um widget customizado no Elementor com o ACF PRO é, no fundo, separar o dado do desenho: crie o grupo de campos, defina onde ele aparece, monte o widget e, acima de tudo, conecte a Dynamic Tag ao campo certo em vez de digitar texto fixo. A tag esquecida é o que faz o widget parecer dinâmico sem ser, então confirme que cada bloco puxa de um campo. Para padronizar o Elementor Pro em vários sites sem licença avulsa, conheça os planos da FULL, e para continuar aprendendo, o FULL Academy reúne os tutoriais de WordPress em um só lugar.