--- title: "Como corrigir o erro de query no JetEngine quando o Listing não filtra" url: https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o erro de query no JetEngine quando o Listing não filtra ## O que é o JetEngine Listing que não filtra? O Listing Grid do JetEngine renderiza uma listagem dinamica e, quando ha um filtro do JetSmartFilters na página, o filtro precisa saber exatamente qual query do grid atualizar. Esse vinculo e feito pelo Query ID: o mesmo identificador tem de estar no filtro e no Listing Grid. Se o grid usa uma Custom Query montada no Query Builder, o Query ID dessa consulta também precisa bater. Quando os identificadores divergem, ou quando o provider do filtro não aponta para o JetEngine, o filtro envia a requisicao mas a query do grid ignora os argumentos e devolve a listagem padrão, sem filtrar. O resultado e um grid que recarrega visualmente, porém mostra sempre os mesmos resultados. ## Como identificar - Você escolhe uma opção no filtro, o Listing Grid recarrega ou pisca, mas o JetEngine Listing não filtra e os mesmos posts continuam na lista. - A URL ganha o parametro do filtro, por exemplo jsf ou meta_category, mas a contagem de resultados do grid não muda. - Com dois Listing Grids na mesma página, o filtro afeta o grid errado ou nenhum, sinal de Query ID ausente ou repetido. - O grid que usa Custom Query do Query Builder ignora o filtro por completo, enquanto um grid simples na mesma página filtra normal. ## Como prevenir - Atribua um Query ID único a cada Listing Grid já na montagem da página e repita o mesmo valor em todos os filtros que controlam aquele grid - Sempre que o grid usar uma Custom Query do Query Builder, defina o mesmo Query ID na consulta antes de adicionar filtros - Padronize o formato do Query ID com letras minusculas e hifen, evitando espacos, números e caracteres especiais que quebram o vinculo Erros relacionados - [Como corrigir o JetSmartFilters que não filtra dados dinâmicos](https://full.services/wp-fixer/corrigir-jetsmartfilters-nao-filtra-jetengine/) - [Como corrigir o erro de query no Listing Grid do JetEngine](https://full.services/wp-fixer/corrigir-erro-query-jetengine-listing-grid/) - [Como corrigir o JetSmartFilters AJAX que não retorna resultados](https://full.services/wp-fixer/corrigir-jetsmartfilters-ajax-sem-resultados/) --- ## 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-query-listing-nao-filtra-jetengine/#article", "headline": "Como corrigir o erro de query no JetEngine quando o Listing não filtra", "url": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:08-03:00", "dateModified": "2026-06-17T12:39:29-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-query-listing-nao-filtra-jetengine/" }, "wordCount": 791, "description": "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.", "articleSection": "Page Builders", "keywords": "erro de query no jetengine listing, jetengine custom query nao filtra com jetsmartfilters, jetengine listing grid nao filtra, jetengine query id listing grid", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://crocoblock.com/knowledge-base/jetsmartfilters/how-to-assign-filter-to-specific-listing-grid/", "name": "Crocoblock — How to Set Query ID for Filters and Listing Grid" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o erro de query no JetEngine quando o Listing não filtra", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q1", "name": "Por que meu JetEngine Listing não filtra mesmo com o filtro na página?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na maioria dos casos o Query ID do filtro não e identico ao do Listing Grid. O filtro precisa do mesmo identificador do grid para saber qual query atualizar. Cole exatamente o mesmo valor nos dois widgets, sem espacos, números ou caracteres especiais, e teste de novo.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q2", "name": "O que e o Query ID no Listing Grid do JetEngine?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O Query ID e um identificador único que conecta o filtro a uma query específica do grid. Quando ha mais de um Listing Grid na página ou o grid usa uma Custom Query, o filtro so encontra a listagem certa se o mesmo Query ID estiver definido no grid e no filtro. Sem esse vinculo, o filtro não atualiza nada.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q3", "name": "Meu grid usa Custom Query do Query Builder e o filtro não funciona. O que falta?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Falta repetir o Query ID na própria consulta do Query Builder. Quando o Listing Grid puxa uma Custom Query, o filtro mira a query padrão do grid, não a custom, a menos que a consulta tenha o mesmo Query ID. Abra a consulta no Query Builder, defina o Query ID e repita o valor no grid e no filtro.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q4", "name": "Tenho dois Listing Grids e o filtro mexe no grid errado. Como resolver?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Isso e Query ID ausente ou repetido. Dê um Query ID único a cada grid e use, em cada filtro, o identificador do grid que ele deve controlar. Assim o JetSmartFilters distingue as duas queries e cada filtro atualiza so a listagem que você vinculou a ele.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q5", "name": "O provider errado também faz o Listing não filtrar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Se o campo This filter for do filtro aponta para WooCommerce Archive ou outro provedor, ele não fala com a query do Listing Grid do JetEngine. Para um grid comum o provider e JetEngine, e para uma listagem de Custom Content Type e o JetEngine de CCT. Ajuste o provider e o filtro volta a agir sobre o grid.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q6", "name": "O Query ID pode ter qualquer formato?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não. O valor precisa ser único e sem espacos, números ou caracteres especiais. Use so letras minusculas e hifen, como filtro-imoveis. Um identificador com número ou espaco não casa entre o filtro e o grid, e o filtro deixa de encontrar a query certa.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q7", "name": "Como confirmo se o filtro chega até a query do grid?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Use o hook do provedor JetEngine para registrar os argumentos da query. Conectando uma função ao filtro jet-engine/listing/grid/posts-query-args você loga os query args no debug.log e ve se os criterios do filtro estão presentes. Se não estiverem, o vinculo de Query ID ou provider ainda esta errado.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-query-listing-nao-filtra-jetengine/#faq-q8", "name": "Limpar cache ajuda quando o Listing não filtra?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Ajuda apenas quando a causa e cache servindo a resposta antiga do AJAX. Antes disso, corrija o Query ID e o provider, que respondem pela maioria dos casos. Se já estiverem certos e o grid ainda repetir a mesma lista por AJAX, limpe o cache do site e do CDN e exclua o admin-ajax do cache de página.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```