Listing Grid vazio JetEngine: como corrigir

Tipo Page Builders

Nome do erro Listing Grid vazio no JetEngine EN: JetEngine Listing Grid empty

Severidade Grave

Descrição O Listing Grid vazio no JetEngine ocorre quando a query (Post Status, Meta Query, Tax Query, Offset ou Cache Query) não retorna nenhum item para o Listing template. Corrige-se alinhando os parametros do Query Builder a dados que existem no site.

O que é Listing Grid vazio JetEngine?

O Listing Grid vazio JetEngine acontece quando o widget Listing Grid renderiza o Listing template, mas a query por tras dele devolve zero itens, deixando a área em branco no editor e no frontend. O Listing Grid não inventa dados: ele exibe exatamente o que a fonte de query retorna. Quando o Post Type escolhido não tem posts publicados, ou quando uma clausula de Meta Query, Tax Query, Date Query ou Offset filtra todos os registros, o grid fica vazio mesmo com o template montado corretamente. O mesmo vale para Custom Query do Query Builder cujo módulo (Custom Content Type, REST API, Data Store) não esta ativado no JetEngine Dashboard.

Como identificar

Área do Listing Grid aparece totalmente em branco no frontend, sem cards e sem mensagem de erro
No editor Elementor ou Gutenberg o widget mostra ‘No data was found’ ou simplesmente nenhum item de exemplo
O Listing template abre normalmente sozinho, mas zera ao ser inserido no Listing Grid da página
Os itens existem em JetEngine -> Query Builder ao testar a query, mas não chegam ao grid publicado
O grid funciona logado como admin e fica vazio para visitante deslogado

Como prevenir

Sempre criar e testar a query em JetEngine -> Query Builder antes de inserir o Listing template no grid, conferindo a contagem de itens retornados
Documentar o Type esperado de cada meta field para nunca comparar número como Char nem data como texto na Meta Query
Manter o Cache Query ligado em producao por performance, mas desliga-lo durante a depuração e religar so depois de validar os dados
Padronizar Post Status em Publish nas queries de frontend e revisar a paginação (Offset e Posts Per Page) ao reaproveitar uma query em outra página

Causa

O campo Post Status da query não inclui o status real dos itens: a query pede 'Publish' mas os posts estão em Draft, Pending ou Private, entao nenhum entra na lista.
Uma clausula de Meta Query usa o Type errado (Char em campo numerico, ou Date em campo de texto) ou o operador Equal com um Value que nenhum registro possui, descartando todos os itens.
A Tax Query aponta para o Field errado (Term ID quando o valor informado e o Slug) ou para um termo inexistente na taxonomia, resultando em zero correspondencias.
O valor de Offset em Pagination e maior que o total de itens, ou Posts Per Page esta em 0, fazendo a query pular todos os resultados.
A Custom Query selecionada e de um Query Type cujo módulo não esta ativado em JetEngine -> JetEngine -> Modules (Custom Content Type, REST API Listings ou Data Stores), entao a fonte retorna vazia.
O switcher Cache Query, ligado por padrão, serve um resultado em cache desatualizado depois que os posts ou meta campos mudaram, exibindo o estado antigo (vazio).

Como resolver

Confirme o Post Type e o Post Status da query: Abra a query usada pelo Listing template e garanta que o Post Type tem itens publicados e que o Post Status cobre os estados reais dos registros. Esse e o motivo número um de grid vazio quando os posts estão em rascunho.
```
WordPress Dashboard -> JetEngine -> Query Builder -> (sua query) -> aba General
Post Type: selecione o mesmo post type do Listing template
Post Status: marque Publish (e Private/Draft apenas se for intencional exibi-los)
```

Revise as clausulas de Meta Query e Tax Query: Filtros de meta e taxonomia são a causa mais comum de zero itens. Verifique o operador, o Type do dado e se o termo realmente existe. Um Type incorreto faz a comparacao falhar silenciosamente.

aba Meta Query -> confira Field key/name, Compare e Type (Numeric para número, Date para data)
aba Tax Query -> confira Taxonomy, Field (Term ID / Slug / Name) e Terms
Remova temporariamente cada clausula para isolar qual delas zera o resultado

Cheque Pagination, Offset e o módulo da Custom Query: Um Offset alto pula todos os itens e um módulo desativado faz a fonte retornar vazia. Ajuste a paginação e ative o módulo correspondente ao Query Type.

aba Pagination -> Offset: 0 | Posts Per Page: 9 (ou -1 para todos)
WordPress Dashboard -> JetEngine -> JetEngine -> aba Modules
Ative o módulo do tipo usado: Custom Content Type, REST API Listings ou Data Stores

Desligue o Cache Query e revalide: A doc do Crocoblock recomenda desativar o Cache Query quando ha resultados incorretos. Desligue, salve e recarregue a página sem cache do navegador para confirmar se o grid volta a popular.
```
aba General da query -> desative o switcher Cache Query
Salve a query e limpe o cache de plugins (WP Rocket / LiteSpeed) se houver
Recarregue a página do Listing Grid em aba anonima para validar
```

PHP

// Diagnostico rapido: rode a mesma query do Listing Grid via WP_Query e veja a contagem real.
// Cole em um snippet (Code Snippets / functions.php) e acesse ?jetdiag=1 como admin.
add_action( 'init', function () {
    if ( ! isset( $_GET['jetdiag'] ) || ! current_user_can( 'manage_options' ) ) {
        return;
    }
    $args = array(
        'post_type'      => 'projeto',   // troque pelo Post Type do seu Listing
        'post_status'    => 'publish',
        'posts_per_page' => 9,
        'offset'         => 0,
        'meta_query'     => array(
            array(
                'key'     => 'ativo',
                'value'   => '1',
                'compare' => '=',
                'type'    => 'NUMERIC',
            ),
        ),
    );
    $q = new WP_Query( $args );
    error_log( 'JetEngine listing diag -> itens encontrados: ' . $q->found_posts );
    wp_die( 'Itens encontrados: ' . intval( $q->found_posts ) );
} );

Perguntas frequentes

Por que o Listing Grid do JetEngine aparece vazio so no frontend e não no editor?

Geralmente porque o Post Status da query inclui rascunhos visiveis ao admin no editor, mas o visitante deslogado so enxerga itens com status Publish. Ajuste o Post Status para Publish e confirme que existem posts publicados daquele Post Type.

Como saber qual clausula de query esta zerando o Listing Grid?

Abra a query em JetEngine -> Query Builder e remova uma clausula de Meta Query ou Tax Query por vez, salvando e recarregando o grid. Quando os itens voltarem a aparecer, a última clausula removida era a responsável pelo filtro restritivo.

O Cache Query do JetEngine pode deixar o Listing Grid vazio?

Sim. O Cache Query fica ligado por padrão e pode servir um resultado antigo após você alterar posts ou meta fields. A documentação do Crocoblock recomenda desativar o switcher Cache Query quando os resultados estiverem incorretos e revalidar a página.

Meu Listing Grid usa Custom Content Type e não mostra nada. O que falta?

O módulo Custom Content Type precisa estar ativado em JetEngine -> JetEngine -> Modules. Query Types como Custom Content Type, REST API e Data Store so retornam dados com o módulo correspondente habilitado no JetEngine Dashboard.

Um Offset errado pode esvaziar o Listing Grid?

Pode. Na aba Pagination, o valor de Offset pula esse número de itens iniciais. Se o Offset for maior ou igual ao total de resultados, a query pula todos e o grid fica vazio. Defina Offset como 0 para exibir desde o primeiro item.

Por que a Tax Query não retorna posts mesmo com o termo certo?

Quase sempre o campo Field esta divergente do valor informado em Terms. Se Field for Term ID, o Terms precisa ser o ID numerico; se for Slug, precisa ser o slug. Alinhe Field e Terms e confirme que o termo existe na taxonomia selecionada.

O Type da Meta Query interfere no resultado do Listing Grid?

Sim, e bastante. Comparar um campo numerico com Type Char, ou uma data com Type texto, faz a clausula não casar com nenhum registro. Defina Numeric para números, Date ou Datetime para datas e Char para texto livre.

Preciso recriar o Listing template para corrigir o grid vazio?

Normalmente não. O Listing Grid vazio quase sempre e problema da query, não do template. Corrija Post Status, Meta Query, Tax Query, Offset, módulo e Cache Query no Query Builder antes de cogitar refazer o template.

Grave

Como corrigir o erro de query no JetEngine quando o Listing não filtra

Quando o JetEngine Listing não filtra, o filtro do JetSmartFilters dispara, o grid recarrega, mas os mesmos itens continuam na tela. A causa quase sempre e o Query ID divergente entre o filtro e o Listing Grid, uma Custom Query do Query Builder sem o mesmo Query ID, ou o provider apontando para a listagem errada.

Grave

Como corrigir layout quebrado no mobile após atualizar o Elementor

O layout mobile do Elementor quebra depois de atualizar quando os novos breakpoints do plugin deslocam onde os estilos responsivos são aplicados e o CSS antigo de cada página não e regenerado. No desktop o site parece normal, mas no celular o conteúdo aparece sobreposto, com colunas empilhadas erradas ou fora de largura.

Grave

Como corrigir o Theme Builder do Elementor que não aplica em todas as páginas

O Theme Builder não aplica em todas as páginas quando o template foi salvo como rascunho, ficou sem condicao de exibicao, ou perde para outro template do mesmo tipo com condicao mais específica. O ajuste e definir Include corretamente e revisar a especificidade entre templates concorrentes.

Atenção

Como corrigir a falha de upload de arquivos no JetFormBuilder

A falha de upload no JetFormBuilder acontece quando o campo Media Field rejeita o arquivo por exceder o limite de tamanho ou de quantidade, por não casar com o ALLOW MIME TYPES configurado, ou por o usuário não ter o nível de USER ACCESS exigido para enviar.

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.

Atenção

Como corrigir o JetCompareWishlist que não adiciona produtos no WordPress

O JetCompareWishlist não adiciona produto quando o botão Comparar ou Lista de Desejos é colocado fora de um loop de produtos, quando as páginas de comparação e de lista não estão definidas nas configurações, ou quando o cache, um conflito de JavaScript ou cookies bloqueados impedem a requisição AJAX que salva o item.

Setores

Extensões

Integrações

Como corrigir o Listing Grid vazio no JetEngine

O que é Listing Grid vazio JetEngine?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro de query no JetEngine quando o Listing não filtra

Como corrigir layout quebrado no mobile após atualizar o Elementor

Como corrigir o Theme Builder do Elementor que não aplica em todas as páginas

Como corrigir a falha de upload de arquivos no JetFormBuilder

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

Como corrigir o JetCompareWishlist que não adiciona produtos no WordPress

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