# Como corrigir pop-ups que não aparecem no Elementor

Quando o popup do Elementor não aparece, a janela criada no Popup Builder nunca abre no site publicado. As causas comuns são falta de Condicao de exibicao em Publicar, Gatilho ausente sem link de disparo, o cookie de frequencia já gravado, ou o cache minificando o script do popup.

## O que é o popup que não aparece no Elementor?

O Popup Builder do Elementor Pro cria janelas modais que abrem sobre a página sob gatilhos e condicoes definidos no momento de publicar o popup. Para o popup aparecer no site ele precisa de três coisas certas ao mesmo tempo: uma Condicao que diga em quais páginas ele pode surgir, um Gatilho ou um link de disparo que decida quando abrir, e nenhuma regra avancada ou cookie de frequencia bloqueando aquela sessao. Se qualquer um desses três elos falhar, o popup fica salvo no editor, mas nunca abre para o visitante.

## Como identificar

- O popup funciona na previa do editor (botao do olho em Publicar), mas nunca abre no site publicado.
- Ao publicar o popup, a aba Condicoes mostra a mensagem 'Você não tem nenhuma condicao ainda' e nenhuma página foi adicionada.
- O popup so abre na primeira visita e nunca mais reaparece, porque o cookie 'Não mostrar novamente' ou o limite de frequencia já foi atingido.
- O console do navegador (F12) mostra erro de JavaScript ou os scripts do Elementor (frontend.min.js) não carregam, e o popup não dispara em nenhum gatilho.

**Antes de começar:** Antes de editar o footer.php do tema, faca backup do arquivo e use sempre um tema filho. Editar o arquivo do tema pai diretamente faz a alteração ser perdida na próxima atualização do tema, e um erro de sintaxe no footer.php derruba todas as páginas do site.

## Como prevenir

- Ao criar todo popup, defina a Condicao e o Gatilho antes de publicar, e teste numa janela anonima para validar o disparo limpo
- Exclua os scripts do Elementor (frontend.min.js) da minificacao e combinacao de JS no plugin de cache desde a configuração inicial
- Documente o limite de frequencia de cada popup para não confundir supressao por cookie com popup quebrado nos testes

Erros relacionados

- [Como corrigir o Theme Builder do Elementor que não aplica em todas as páginas](https://full.services/wp-fixer/corrigir-theme-builder-condicoes-elementor/)
- [Como corrigir conflitos entre o Elementor e plugins de cache](https://full.services/wp-fixer/corrigir-conflito-elementor-cache/)
- [Como corrigir o erro 'Preview Could Not Be Loaded' no Elementor](https://full.services/wp-fixer/corrigir-preview-could-not-be-loaded-elementor/)

## Causa

- Nenhuma Condicao de exibicao definida na aba Condicoes ao publicar o popup, entao o Elementor não tem em qual página mostra-lo e ele nunca aparece.
- Gatilho ausente na aba Gatilhos (On Page Load, On Scroll, On Click, After Inactivity ou Exit Intent) e também sem link com a classe elementor-popup ou a URL acao popup para disparar manualmente.
- Regra avancada de frequencia ativa (Mostrar até X vezes ou o cookie Não mostrar novamente) já gravada no navegador, suprimindo o popup nas visitas seguintes.
- Minificacao ou combinacao de JavaScript no plugin de cache (WP Rocket, LiteSpeed, Autoptimize) quebrando o frontend.min.js que dispara o popup.
- Tema que não emite o gancho wp_footer no rodape, impedindo o Elementor de injetar o markup do popup na página.

## Como resolver

1. Confirme uma Condicao de exibicao: abra o popup no editor, clique na seta ao lado de Publicar e va na aba Condicoes. Se estiver vazia, adicione uma condicao como Todo o site (Include / Entire Site) ou uma página específica. Sem condicao, o popup nunca aparece.
2. Defina um Gatilho ou link de disparo: na aba Gatilhos, ative pelo menos um gatilho. Se o popup deve abrir por clique, deixe os gatilhos desligados e aponte o link para a acao de popup pelo menu Acoes Dinamicas do botao, ou use a classe abaixo no elemento de disparo.

```
elementor-popup-12345
```

3. Limpe o cookie de frequencia: abra o site numa janela anonima ou apague os cookies do domínio para descartar o cookie Não mostrar novamente. Em seguida, na aba Regras Avancadas, revise o limite Mostrar até X vezes para não bloquear o popup em visitas legitimas.
4. Exclua o Elementor da minificacao de JS: no plugin de cache, exclua o frontend.min.js do Elementor da minificacao e da combinacao de JavaScript, ou desative o cache para testar. Limpe o cache do site e do navegador depois.

```
/wp-content/plugins/elementor/assets/js/frontend.min.js
/wp-content/plugins/elementor-pro/assets/js/frontend.min.js
```

5. Garanta o wp_footer no tema: se o popup não injeta nenhum markup na página, confirme que o tema chama o gancho de rodape do WordPress. Abra o footer.php do tema ou tema filho e verifique a presenca da chamada abaixo antes do fechamento do body.

```
wp_footer();
```


## Código

```css
/* Abrir um popup do Elementor ao clicar num botao ou link */
/* 1. Em Modelos > Popups, copie o ID do popup (ex.: 12345). */
/* 2. Adicione esta classe no botao/link em Avancado > CSS Classes: */
.elementor-popup-12345

/* 3. O Elementor liga essa classe ao popup automaticamente. */
/* Alternativa por link: aponte o href do botao para a acao de popup */
/* via menu Acoes Dinamicas (Elementor Pro), sem digitar URL manual. */
```

## Perguntas frequentes

### Por que o popup do Elementor funciona na previa mas não no site?

A previa do editor ignora as Condicoes, os Gatilhos e o cookie de frequencia. No site publicado esses três precisam estar certos. Quase sempre falta uma Condicao de exibicao ou o Gatilho, entao o popup esta salvo, mas nunca recebe a ordem de abrir para o visitante real.

### Configurei o popup mas ele não aparece em nenhuma página. O que falta?

Quase sempre falta a Condicao de exibicao. Ao publicar, va na aba Condicoes e adicione onde o popup pode surgir, como Todo o site ou uma página específica. Sem nenhuma condicao, o Elementor não tem onde mostrar o popup e ele nunca abre.

### O popup so abriu uma vez e nunca mais voltou. Por que?

Isso e a regra de frequencia: o cookie Não mostrar novamente ou o limite Mostrar até X vezes já foi atingido naquele navegador. Teste numa janela anonima ou apague os cookies do domínio. Se voltar a aparecer, ajuste a frequencia na aba Regras Avancadas.

### O plugin de cache pode impedir o popup de aparecer?

Pode. A minificacao e a combinacao de JavaScript quebram o frontend.min.js do Elementor que dispara o popup. Exclua os scripts do Elementor dessas otimizacoes ou desative o cache para confirmar. Limpe o cache do site e do navegador após a mudanca para o teste valer.

### Como faco o popup abrir ao clicar num botao?

Deixe os gatilhos automaticos desligados e aponte o link do botao para a acao de popup pelo menu Acoes Dinamicas, ou adicione uma classe CSS como elementor-popup-12345 no elemento, trocando 12345 pelo ID real do popup. Assim o popup abre so no clique, sem disparar sozinho.

### O tema influencia o popup do Elementor não aparecer?

Sim. O Elementor injeta o markup do popup pelo gancho wp_footer do WordPress. Se o tema não chama wp_footer no footer.php, o popup nunca e inserido na página. Confirme a chamada no tema ou tema filho; temas bem feitos sempre incluem esse gancho.

### Onde fica o ID do popup no Elementor?

O ID aparece em Modelos > Popups, na coluna ID de cada popup, e também na URL ao editar o popup, no parametro post. Esse número e o que você usa na classe elementor-popup-ID para abrir o popup por clique num link ou botao.

### Preciso do Elementor Pro para usar popups?

Sim. O Popup Builder e um recurso exclusivo do Elementor Pro. Se o Elementor Pro estiver inativo ou com a licenca expirada, os popups param de funcionar e não aparecem no site. Confirme em Plugins que o Elementor Pro esta ativo e a licenca registrada.

**Fonte:** [Elementor — Popups](https://elementor.com/help/popups/)