--- title: "Como corrigir o erro de query no Listing Grid do JetEngine" url: https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o erro de query no Listing Grid do JetEngine ## O que é o erro de query no Listing Grid do JetEngine? O erro de query no Listing Grid do JetEngine acontece quando o widget de Listing aponta para uma Custom Query criada no Query Builder e essa query falha ao executar ou devolve zero linhas. O Query Builder e a ferramenta do JetEngine que monta a consulta ao banco (Posts Query, Terms Query, Users Query, SQL/AI Query, CCT Query, REST API Query, entre outras) e entrega o resultado ao Listing Grid quando a opção Use custom query esta ligada e a query certa esta escolhida no dropdown Custom Query. ## Como identificar - O Listing Grid renderiza vazio no frontend, mas o mesmo Listing com a query padrão do Post Type mostra os itens normalmente. - Com WP_DEBUG ligado, a página exibe WordPress database error perto da abertura do grid, indicando que a query do tipo SQL chegou malformada ao banco. - No editor da query, o botao Preview do Query Builder mostra os registros, mas no frontend o Listing Grid continua sem resultados. - O Listing Grid mostra apenas a mensagem de no posts found, ou a paginação some, mesmo com itens existentes que deveriam casar com o filtro. - O Listing Grid exibe um erro de macro não resolvida quando a query usa um valor dinamico como current_post_id ou current_user_id que veio vazio. **Antes de começar:** Antes de editar uma query do tipo SQL Query ou apagar condicoes de uma query em producao, faca backup do site e do banco de dados: uma query SQL mal escrita pode ler tabelas além do esperado e, em páginas de alto tráfego, sobrecarregar o banco. Teste a query no Preview e, de preferencia, em ambiente de staging antes de publicar. ## Como prevenir - Sempre rode o Preview da query no Query Builder antes de liga-la a um Listing Grid, confirmando que ela retorna linhas isolada do frontend - Use o Query Type que corresponde ao objeto do Listing Template, evitando misturar Users Query ou Terms Query num Listing montado sobre Post Type - Evite o tipo SQL Query quando uma Posts Query ou CCT Query resolve, e quando usar SQL teste a instrucao com o prefixo de tabela correto antes de salvar - Exclua o Listing do cache de objeto agressivo enquanto edita queries, para não confundir um resultado em cache com um erro real Erros relacionados - [Como corrigir o Listing Grid vazio no JetEngine](https://full.services/wp-fixer/corrigir-listing-grid-vazio-jetengine/) - [Como corrigir as queries lentas do JetEngine no banco de dados](https://full.services/wp-fixer/corrigir-jetengine-queries-lentas/) - [Como corrigir o erro de query no JetEngine quando o Listing não filtra](https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#article", "headline": "Como corrigir o erro de query no Listing Grid do JetEngine", "url": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:07-03:00", "dateModified": "2026-06-17T12:39:07-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": false, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "Page Builders" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/" }, "wordCount": 957, "description": "O erro de query no Listing Grid do JetEngine ocorre quando a Custom Query do Query Builder falha ou não retorna nada: tipo de query trocado, SQL invalido, meta query que exclui todos os registros ou macro vazia. O grid fica vazio ou exibe aviso de banco enquanto o Preview do Query Builder parece correto.", "articleSection": "Page Builders", "keywords": "jetengine query builder nao retorna, jetengine sql query type erro, listing grid jetengine erro de query, use custom query jetengine listing grid", "proficiencyLevel": "Advanced", "citation": { "@type": "CreativeWork", "url": "https://crocoblock.com/knowledge-base/jetengine/jetengine-query-builder-sql-query-type/", "name": "JetEngine — SQL/AI Query Type of Query Builder" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o erro de query no Listing Grid do JetEngine", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q1", "name": "Por que o Listing Grid do JetEngine aparece vazio mesmo com itens cadastrados?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Quase sempre a Custom Query ligada no grid esta com o Query Type errado, com uma Meta Query que exclui todos os registros, ou aponta para uma query renomeada. Abra o Listing Grid, confira o dropdown Custom Query e rode o Preview da query no Query Builder para ver se ela retorna linhas isolada do frontend.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q2", "name": "Como vejo o erro real da query em vez do grid so vazio?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Ligue WP_DEBUG e WP_DEBUG_LOG no wp-config.php e recarregue a página do Listing. Se a query do tipo SQL Query estiver malformada, o WordPress registra um database error com a tabela ou clausula que o MySQL rejeitou, o que aponta a causa direta em vez de você so ver o grid vazio.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q3", "name": "A query funciona no Preview do Query Builder mas o Listing Grid fica vazio. Por que?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Isso acontece quando o Query Type não casa com o objeto que o Listing Template renderiza, ou quando uma macro como current_post_id resolve para vazio no contexto da página. O Preview roda fora desse contexto, entao mostra resultado; no frontend a macro vazia filtra tudo. Ajuste o Query Type e revise as macros.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q4", "name": "O que e a opção Use custom query no Listing Grid?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "E o toggle que faz o Listing Grid usar uma query montada no Query Builder em vez da query padrão do Post Type. Quando ligado, abre o dropdown Custom Query para você escolher qual query alimenta o grid. Se nenhuma query valida estiver selecionada, o grid fica sem fonte de dados e retorna vazio.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q5", "name": "Posso usar uma query do tipo SQL Query no Listing Grid?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode, o SQL Query Type le dados direto de tabelas do banco e entrega ao Listing Grid. Mas qualquer erro de sintaxe ou tabela sem o prefixo correto da instalação vira um database error. Teste a instrucao com cuidado e prefira Posts Query ou CCT Query quando elas resolverem o mesmo objetivo.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q6", "name": "Por que minha Meta Query deixa o Listing Grid sem resultados?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Uma condicao de Meta Query com compare EXISTS, um valor que nenhum registro possui, ou o tipo de valor errado elimina todas as linhas sem gerar erro visivel. Remova as condicoes uma a uma no Query Builder até o grid voltar a retornar para isolar qual filtro estava zerando o resultado.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q7", "name": "O cache pode mascarar a correção da query?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. O cache de objeto ou de página pode servir o resultado antigo da query depois de você corrigi-la, fazendo o grid continuar vazio mesmo com a query já certa. Limpe o cache de página e de objeto e recarregue com Ctrl+Shift+R para validar a correção no frontend.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/#faq-q8", "name": "Preciso editar arquivo para resolver ou da pelo painel do JetEngine?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na maioria dos casos resolve pelo painel: reselecionar a Custom Query, ajustar o Query Type e revisar a Meta Query no Query Builder. So e preciso editar arquivo para ligar o WP_DEBUG no wp-config.php quando a query e do tipo SQL e você precisa ler a mensagem exata do banco.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```