--- title: "Como corrigir a incompatibilidade do JetEngine com o WooCommerce 9.x" url: https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir a incompatibilidade do JetEngine com o WooCommerce 9.x ## O que é incompatibilidade do JetEngine com o WooCommerce 9? O JetEngine fica incompativel com o WooCommerce 9 porque o WooCommerce 9.x usa o HPOS (High-Performance Order Storage, ou tabelas de pedidos customizadas wc_orders) como recurso central. Todo plugin que toca em pedidos precisa declarar compatibilidade com esse recurso através de FeaturesUtil::declare_compatibility no gancho before_woocommerce_init. Quando a versão do JetEngine instalada não faz essa declaracao, o WooCommerce marca o plugin como incompativel. O efeito pratico não e o JetEngine quebrar sozinho: o WooCommerce passa a exibir um aviso no painel e desabilita a opção de ativar o HPOS enquanto o plugin estiver na lista de incompativeis. Em lojas que já rodam com HPOS, listagens do JetEngine Query Builder que consultam pedidos por postmeta legado podem voltar vazias quando a sincronizacao entre tabelas esta desligada. ## Como identificar - Aviso no topo do painel: 'The following plugin(s) are incompatible with the active version of WooCommerce but have not declared compatibility with our High-Performance Order Storage feature' listando o JetEngine - Em WooCommerce -> Settings -> Advanced -> Features a opção 'High-Performance order storage' aparece desabilitada com o link 'View and manage' apontando para extensões incompativeis - Na página de plugins um filtro 'Incompatible with WooCommerce feature' lista o JetEngine ao acessar plugins.php?plugin_status=incompatible_with_feature&feature_id=custom_order_tables - Listagens do JetEngine Query Builder do tipo WC Orders retornam vazias depois que o HPOS foi ativado e a sincronizacao com as tabelas legadas foi desligada - Relatórios ou widgets que leem postmeta de pedidos param de exibir dados, sem erro fatal no frontend **Antes de começar:** Faca backup do banco de dados antes de ativar ou alternar o HPOS. A migração move pedidos entre estruturas de tabela e, sem o modo de compatibilidade ligado, voltar atras com pedidos novos já gravados pode exigir restauração. ## Como prevenir - Mantenha o JetEngine e todos os JetPlugins na versão mais recente, já que as declaracoes de compatibilidade chegam junto com as atualizações do plugin - Antes de ativar o HPOS, abra a tela de plugins filtrada por incompatible_with_feature e resolva toda a lista, não apenas o JetEngine - Use um ambiente de staging para ativar o HPOS e validar as listagens de pedidos antes de aplicar em producao - Deixe o modo de compatibilidade ligado nas primeiras semanas para que qualquer consulta que ainda leia postmeta de pedidos continue funcionando Erros relacionados - [Como corrigir o Listing Grid vazio no JetEngine](https://full.services/wp-fixer/corrigir-listing-grid-vazio-jetengine/) - [Como corrigir o erro de conexão entre JetEngine e Elementor](https://full.services/wp-fixer/corrigir-conexao-jetengine-elementor/) - [Como corrigir erros de exibição de produtos do WooCommerce no Elementor](https://full.services/wp-fixer/corrigir-exibicao-produtos-elementor-woocommerce/) --- ## 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-jetengine-incompativel-woocommerce-9/#article", "headline": "Como corrigir a incompatibilidade do JetEngine com o WooCommerce 9.x", "url": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/", "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-jetengine-incompativel-woocommerce-9/" }, "wordCount": 851, "description": "A incompatibilidade do JetEngine com o WooCommerce 9 surge quando o WooCommerce ativa o HPOS (custom order tables) e o JetEngine instalado não declarou compatibilidade com o recurso, o que trava o botao de ativar o armazenamento de pedidos.", "articleSection": "Page Builders", "keywords": "declarar compatibilidade hpos jetengine, jetengine hpos compativel, jetengine incompativel com woocommerce, jetengine plugin incompativel woocommerce, jetengine woocommerce custom order tables", "proficiencyLevel": "Advanced", "citation": { "@type": "CreativeWork", "url": "https://crocoblock.com/knowledge-base/troubleshooting/", "name": "Crocoblock — Plugin Quick Fixes & Troubleshooting (JetEngine)" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir a incompatibilidade do JetEngine com o WooCommerce 9.x", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq-q1", "name": "O JetEngine e compativel com o WooCommerce 9 e o HPOS?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. As versões atuais do JetEngine declaram compatibilidade com o recurso custom_order_tables do WooCommerce. O aviso de incompatibilidade aparece quando a copia instalada esta desatualizada ou quando um add-on da Crocoblock que le pedidos não declarou suporte.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq-q2", "name": "Posso simplesmente desligar o HPOS para resolver?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode, como medida temporaria. Em WooCommerce -> Settings -> Advanced -> Features e possível manter o armazenamento legado, o que remove o bloqueio. Mas a correção definitiva e atualizar o JetEngine, porque o HPOS e o padrão do WooCommerce 9 e tende a ser obrigatório.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq-q3", "name": "Por que o botao de ativar o HPOS aparece desabilitado?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O WooCommerce bloqueia a ativacao do HPOS enquanto existir algum plugin ativo na lista de incompativeis. Enquanto o JetEngine ou um add-on dele estiver sinalizado, a opção fica travada com o link View and manage at remover o plugin da lista.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq-q4", "name": "Atualizar o JetEngine apaga meus pedidos ou listagens?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não. Atualizar o plugin apenas adiciona a declaracao de compatibilidade e correcoes. Os pedidos vivem no banco do WooCommerce, não no JetEngine. Ainda assim, faca backup antes de alternar o HPOS, porque essa troca move dados entre tabelas.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq-q5", "name": "Minhas listagens do JetEngine ficaram vazias depois de ativar o HPOS, e normal?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode acontecer quando a consulta le pedidos via postmeta legado e a sincronizacao esta desligada. Ative o modo de compatibilidade em WooCommerce -> Settings -> Advanced -> Features para que os pedidos existam nas duas estruturas enquanto você ajusta as queries do Query Builder.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq-q6", "name": "Declarei a compatibilidade manualmente e o aviso continua, por que?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Quase sempre o caminho do arquivo passado para FeaturesUtil::declare_compatibility não bate com o arquivo principal real do plugin, ou o código rodou depois do gancho before_woocommerce_init. Confirme o caminho jet-engine/jet-engine.php e que a declaracao roda dentro desse gancho.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-jetengine-incompativel-woocommerce-9/#faq-q7", "name": "Onde vejo todos os plugins incompativeis com o HPOS de uma vez?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na tela de plugins, acesse plugins.php com o filtro plugin_status=incompatible_with_feature e feature_id=custom_order_tables. Ela mostra cada extensão ativa que ainda não declarou compatibilidade, para você tratar a stack inteira e não so o JetEngine.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```