Modal Popup Ultimate Addons não abre: como corrigir

Tipo Page Builders

Nome do erro Modal Popup do Ultimate Addons não abre EN: Ultimate Addons Modal Popup does not open

Severidade Atenção

Descrição O modal popup do Ultimate Addons não abre quando o tipo de gatilho está mal configurado, quando o elemento de clique não recebe a classe ou ID que dispara o modal, ou quando um conflito de JavaScript interrompe o script do widget antes de o popup ser acionado.

O que é Modal Popup do Ultimate Addons que não abre?

O modal popup do Ultimate Addons (UAE) é um widget do Elementor que exibe uma janela sobreposta acionada por um gatilho. Segundo a documentação oficial, ele pode abrir de duas formas: pelo clique em um botão, texto, imagem, ícone ou qualquer outro widget; ou por gatilhos automáticos, como Exit Intent (quando o visitante tenta sair da página), After Few Seconds (depois de alguns segundos) e com controle de frequência via cookies. O conteúdo do modal fica oculto até que o gatilho configurado seja disparado.

Quando o modal não abre, a integração entre o gatilho e o widget falhou em algum ponto: o botão de disparo não está apontando para o modal correto, o tipo de gatilho escolhido não corresponde ao comportamento esperado, ou um erro de JavaScript no console derruba o script do UAE antes de o clique ser registrado. Como o widget depende de JS no frontend, qualquer interrupção no carregamento da página impede a abertura, mesmo com o modal corretamente montado no editor.

Como identificar

Você clica no botão, imagem ou ícone configurado e nada acontece: o modal popup não aparece e a página continua igual.
O modal funciona dentro do editor do Elementor (na prévia), mas não abre na página publicada vista pelo visitante.
No console do navegador (F12 -> Console) surgem erros de JavaScript como ‘Uncaught TypeError’ ou ‘is not a function’ ao carregar a página com o widget.
O modal abre sozinho ao carregar a página ou no Exit Intent, mas nunca abre pelo clique no botão que você configurou como gatilho.
O botão de disparo aparece, mas inspecionando o elemento (botão direito -> Inspecionar) ele não tem a classe ou o ID que o gatilho do modal espera.

Antes de começar: Antes de desativar plugins, trocar o tema ou mexer nas configurações de cache em produção, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter caso alguma página quebre.

Como prevenir

Padronize o uso de uma classe CSS própria como gatilho do modal e documente qual elemento dispara cada popup, evitando seletores soltos que somem em ajustes futuros.
Mantenha o Elementor e o Ultimate Addons for Elementor sempre na versão estável mais recente, validando antes em staging para acompanhar mudanças nos controles de gatilho do modal.
Configure exceções no plugin de cache para não minificar nem adiar os scripts do Elementor e do UAE, que o modal popup depende para abrir.
Verifique o console do navegador depois de publicar páginas com modal, garantindo que nenhum plugin novo introduziu erro de JavaScript que derrube o gatilho.

Causa

O tipo de gatilho do widget está em um modo automático (Exit Intent, After Few Seconds ou On Page Load) quando o esperado era abrir por clique, então nenhum clique no botão dispara o modal.
O elemento que deveria abrir o modal (botão, imagem ou ícone) não recebeu a classe CSS ou o ID que o gatilho do Ultimate Addons usa como seletor para detectar o clique, conforme o guia oficial de abrir o modal pelo clique de um widget.
Um erro de JavaScript de outro plugin ou do tema interrompe o carregamento dos scripts do Elementor e do UAE antes da inicialização do modal, deixando o gatilho inerte no frontend.
Um plugin de otimização (minify, defer ou combinação de JavaScript) atrasou ou quebrou o script do widget Modal Popup, fazendo o handler do clique não registrar na página publicada.
O cache da página entregou uma versão antiga, anterior à configuração do gatilho, então o visitante recebe HTML sem o modal devidamente vinculado ao botão.
O Ultimate Addons for Elementor ou o próprio Elementor está desatualizado e o controle de gatilho do modal mudou de comportamento entre versões, deixando a configuração antiga sem efeito.

Como resolver

Confira o tipo de gatilho do widget Modal Popup: Edite a página no Elementor, selecione o widget Modal Popup e abra a aba de conteúdo. Verifique se o gatilho está no modo desejado: para abrir no clique, escolha o disparo por widget ou botão; os modos Exit Intent e After Few Seconds são automáticos e não respondem a clique.
```
Painel WP -> Páginas -> Editar com Elementor
Selecione o widget Modal Popup -> aba Conteúdo -> seção de Trigger/Display Settings
Defina o gatilho de clique e desmarque Exit Intent / After Few Seconds se não forem o objetivo
```
Vincule o botão de clique ao modal pela classe ou ID: Se você usa um botão externo para abrir o modal, ele precisa carregar exatamente a classe CSS ou o ID que o Ultimate Addons usa como gatilho. Abra as configurações avançadas do botão e adicione o seletor indicado pelo widget Modal Popup.
```
Selecione o botão de disparo -> aba Avançado -> CSS Classes
Insira a classe de gatilho definida no widget Modal Popup (ex.: a classe do seletor de abertura)
Salve e atualize a página para aplicar o vínculo
```
Teste o modal na página publicada, não só no editor: Abra a página real em uma aba anônima e clique no gatilho. O modal pode funcionar na prévia do editor e falhar no frontend por causa de cache ou scripts. Se falhar, prossiga para isolar conflito.
```
Abra a URL pública da página em uma janela anônima do navegador
Clique no botão ou elemento de gatilho e observe se o modal abre
Compare o comportamento com a prévia dentro do editor do Elementor
```
Inspecione o console em busca de erros de JavaScript: Abra o console do navegador na página publicada e recarregue. Erros de JavaScript de outro plugin interrompem o script do UAE e impedem o clique de abrir o modal. Anote o arquivo que dispara o erro para identificar o culpado.
```
Abra o console do navegador: tecla F12 -> aba Console
Recarregue a página e observe linhas em vermelho ao carregar
Anote o plugin ou arquivo .js citado no erro
```
Desative otimização de JavaScript e limpe o cache: Plugins de cache que minificam, adiam ou combinam JavaScript costumam quebrar o script do Modal Popup. Desligue essas opções para os scripts do Elementor, limpe todo o cache e teste o gatilho novamente.
```
No plugin de cache, desative Minify/Combine/Defer de JavaScript
Limpe o cache do site e do CDN (purge total)
Recarregue a página publicada e teste o clique no gatilho
```
Isole conflito de plugin ou tema: Se o modal ainda não abrir, desative os demais plugins um a um (mantendo Elementor e UAE) e troque temporariamente para um tema padrão, recarregando a página a cada teste até identificar o que interrompe o script do widget.
```
Painel WP -> Plugins -> desative os demais plugins um a um
Painel WP -> Aparência -> Temas -> ative um tema padrão (ex.: Twenty Twenty-Four)
Recarregue a página e teste o gatilho do modal a cada mudança
```

CSS

/* Garante que o botao de gatilho do Modal Popup do UAE fique clicavel */
/* Troque .abre-modal pela classe de gatilho definida no widget Modal Popup */
.abre-modal {
    cursor: pointer;
    position: relative;
    z-index: 10;
    pointer-events: auto;
}

/* Evita que um overlay invisivel de outra secao cubra o gatilho e bloqueie o clique */
.elementor-section-overlap {
    pointer-events: none;
}
.elementor-section-overlap .abre-modal {
    pointer-events: auto;
}

Perguntas frequentes

Por que o modal popup do Ultimate Addons não abre ao clicar no botão

Quase sempre o botão de clique não está vinculado ao modal pela classe ou ID que o widget usa como gatilho, ou o gatilho está em modo automático como Exit Intent. Confirme o tipo de gatilho no widget e adicione a classe de abertura ao botão em Avançado -> CSS Classes.

O modal funciona no editor do Elementor mas não na página publicada

Isso aponta para cache ou conflito de scripts no frontend. Abra a página em uma janela anônima, limpe todo o cache do site e do CDN e desative a minificação de JavaScript do plugin de cache para os scripts do Elementor e do Ultimate Addons.

Quais tipos de gatilho o Modal Popup do Ultimate Addons oferece

Segundo a documentação oficial, o modal abre pelo clique em um botão, texto, imagem, ícone ou outro widget, e por gatilhos automáticos como Exit Intent, After Few Seconds e controle de frequência por cookies. Escolha o gatilho conforme o comportamento desejado.

Como abrir o modal popup pelo clique de outro widget do Elementor

O Ultimate Addons permite acionar o modal por um elemento externo aplicando a classe de gatilho a esse widget. Adicione a classe indicada pelo Modal Popup no campo CSS Classes do widget que deve disparar a abertura, conforme o guia oficial do plugin.

Um erro de JavaScript pode impedir o modal de abrir

Sim. Como o modal popup depende de JavaScript no frontend, um erro de outro plugin ou do tema interrompe o script do widget antes de o clique ser registrado. Abra o console do navegador, identifique o arquivo que dispara o erro e desative o plugin responsável.

O plugin de cache pode quebrar o gatilho do modal popup

Pode. Opções de minificar, combinar ou adiar JavaScript costumam quebrar o script do Modal Popup na página publicada. Crie exceções para os scripts do Elementor e do Ultimate Addons no plugin de cache e limpe o cache após salvar.

O modal abre sozinho mas não abre no clique, o que fazer

O gatilho está configurado em um modo automático como After Few Seconds ou On Page Load. Volte ao widget Modal Popup, ajuste o gatilho para disparo por clique e vincule o botão correto pela classe de abertura do modal.

Preciso atualizar o Ultimate Addons para o modal voltar a abrir

Vale verificar. Versões antigas do Elementor ou do UAE podem usar controles de gatilho diferentes dos atuais, deixando a configuração sem efeito. Atualize ambos para a versão estável mais recente, de preferência testando antes em staging.

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.

Atenção

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

O layout quebrado de páginas de curso do Tutor LMS com Astra Pro acontece quando a página de curso herda o container, a sidebar ou os elementos globais do Astra em vez de usar uma largura total sem barra lateral, deixando o conteúdo do curso estreito, espremido ou desalinhado.

Atenção

Como corrigir o erro de Export/Import com JSON corrompido no ACF PRO

O erro de export/import com JSON corrompido no ACF PRO ocorre quando o arquivo .json do grupo de campos chega malformado, sem a chave key esperada ou com modified inconsistente, fazendo o ACF recusar a importação ou não exibir a sincronizacao.

Grave

Como corrigir erros de cache entre o Elementor e o Cloudflare

O cache entre Elementor e Cloudflare quebra layout e editor quando o Cloudflare serve um CSS antigo de wp-content/uploads/elementor ou quando o Rocket Loader adia os scripts do editor. Regenerar os arquivos do Elementor, purgar o cache do Cloudflare e desligar o Rocket Loader resolve.

Atenção

Como corrigir o WYSIWYG Editor que não carrega no ACF PRO

O ACF WYSIWYG não carrega quando o TinyMCE não é inicializado no campo: o editor aparece em branco ou sem barra de ferramentas, geralmente em campos adicionados dinamicamente dentro de Repeater e Flexible Content ou com a opção Delay initialization ativa.

Grave

Como corrigir os Custom Post Types do JetEngine que não aparecem no frontend

CPT JetEngine que não aparece no frontend quase sempre vem de Public ou Has archive desligados no Post Type, ou de regras de reescrita desatualizadas. Marcar essas opções e regravar os permalinks resolve.

Setores

Extensões

Integrações

Como corrigir o Modal Popup do Ultimate Addons que não abre no WordPress

O que é Modal Popup do Ultimate Addons que não abre?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir conflitos entre o Elementor e plugins de cache

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

Como corrigir o erro de Export/Import com JSON corrompido no ACF PRO

Como corrigir erros de cache entre o Elementor e o Cloudflare

Como corrigir o WYSIWYG Editor que não carrega no ACF PRO

Como corrigir os Custom Post Types do JetEngine que não aparecem no frontend

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