--- title: "Como corrigir a incompatibilidade do ACF PRO com o editor Gutenberg" url: https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir a incompatibilidade do ACF PRO com o editor Gutenberg ## O que é incompatibilidade do ACF PRO Gutenberg? O ACF PRO integra dados ao editor Gutenberg de duas formas: grupos de campos (meta boxes) anexados a posts e páginas por regras de localizacao, e os ACF Blocks, blocos nativos registrados via block.json e renderizados pelo servidor. A incompatibilidade aparece quando essa integração deixa de funcionar: os campos somem do painel lateral do editor, ou um ACF Block exibe a mensagem de bloco quebrado e não renderiza o conteúdo. A causa raiz mais comum, segundo a documentação oficial do ACF, e o uso do plugin Gutenberg standalone instalado a parte. Ele força versões experimentais e novas versões da Block API que o ACF ainda não suporta, derrubando a renderizacao dos ACF Blocks. Versões antigas do ACF (anteriores a 6.0, que introduziu o registro por block.json exigindo WordPress 5.8 ou superior) e erros de configuração do block.json completam o quadro. ## Como identificar - Mensagem 'This block has encountered an error and cannot be previewed' ou 'Your site doesn't include support for this block' aparece no lugar do ACF Block dentro do editor de blocos. - Os grupos de campos do ACF não aparecem mais na lateral nem abaixo do editor ao editar um post ou página no Gutenberg. - O ACF Block some da lista do inserter (botao + 'Adicionar bloco') mesmo com o campo registrado no código. - Aviso 'Block validation' ou 'attempt to recover' surge ao abrir um post que já continha um ACF Block. - No console do navegador aparecem erros de JavaScript da Block API logo ao carregar o editor com o ACF PRO ativo. **Antes de começar:** Antes de editar o block.json ou alternar plugins e tema em producao, faça um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso a previa do editor quebre. ## Como prevenir - Nunca instale o plugin Gutenberg standalone em producao: o editor de blocos já vem no nucleo do WordPress e o plugin força APIs experimentais incompativeis com o ACF. - Mantenha o ACF PRO e o WordPress sempre na versão estavel mais recente, validando antes em staging para acompanhar mudancas da Block API. - Padronize o registro de ACF Blocks por block.json com apiVersion 2 e render_template versionado no repositorio do tema ou plugin. - Documente as regras de localizacao dos grupos de campos para evitar que um ajuste de tipo de post esconda campos do editor sem querer. Erros relacionados - [Como corrigir Custom Fields que não aparecem no frontend no ACF PRO](https://full.services/wp-fixer/corrigir-custom-fields-frontend-acf-pro/) - [Como corrigir o WYSIWYG Editor que não carrega no ACF PRO](https://full.services/wp-fixer/corrigir-wysiwyg-editor-acf-pro/) - [Como corrigir o Flexible Content do ACF PRO que não renderiza no Elementor](https://full.services/wp-fixer/corrigir-flexible-content-elementor-acf-pro/) --- ## 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-compatibilidade-gutenberg-acf-pro/#article", "headline": "Como corrigir a incompatibilidade do ACF PRO com o editor Gutenberg", "url": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:08:48-03:00", "dateModified": "2026-06-17T12:39:06-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-compatibilidade-gutenberg-acf-pro/" }, "wordCount": 946, "description": "A incompatibilidade do ACF PRO com o Gutenberg ocorre quando o plugin Gutenberg standalone, uma versão defasada do ACF ou um block.json mal registrado impedem que campos e ACF Blocks apareçam no editor de blocos.", "articleSection": "Page Builders", "keywords": "acf blocks nao renderiza gutenberg, acf pro incompativel com plugin gutenberg, acf pro nao aparece no editor gutenberg, block.json acf pro nao registra bloco, grupo de campos acf sumiu no editor de blocos", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://www.advancedcustomfields.com/resources/blocks/", "name": "Advanced Custom Fields — ACF Blocks (block editor)" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir a incompatibilidade do ACF PRO com o editor Gutenberg", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq-q1", "name": "Por que meus campos do ACF PRO sumiram do editor Gutenberg", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na maioria dos casos o grupo de campos esta com o status Active desligado ou a regra de localizacao não casa com o tipo de post editado. Em ACF -> Grupos de Campos, reative o grupo e ajuste a localizacao para o post correto.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq-q2", "name": "O plugin Gutenberg standalone quebra o ACF PRO", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. A documentação oficial do ACF afirma que o plugin Gutenberg instalado a parte força versões experimentais da Block API ainda não suportadas pelo ACF, derrubando a renderizacao dos ACF Blocks. Desative esse plugin, pois o editor de blocos já vem no nucleo.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq-q3", "name": "Qual versão do ACF e do WordPress preciso para ACF Blocks no Gutenberg", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O registro de blocos por block.json foi introduzido no ACF 6.0 e exige WordPress 5.8 ou superior. Use o ACF PRO 6.0 ou mais novo e mantenha o WordPress atualizado para o bloco ser reconhecido no editor.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq-q4", "name": "Por que o ACF Block mostra 'This block has encountered an error'", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Esse aviso costuma indicar um block.json com apiVersion incorreta ou um render_template apontando para um arquivo que não existe. Confirme a apiVersion 2 e o caminho do template, que precisa existir na pasta do bloco.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq-q5", "name": "Preciso de JavaScript para renderizar um ACF Block", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não. Os ACF Blocks são dinamicos e renderizados pelo servidor a cada carregamento por um render_template ou render_callback em PHP, sem exigir JavaScript do desenvolvedor, segundo a documentação do ACF.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq-q6", "name": "Posso continuar usando acf_register_block_type em vez de block.json", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Blocos registrados com acf_register_block_type continuam funcionando no ACF 6, mas o registro por block.json passou a ser o metodo recomendado. Migre quando puder para evitar problemas futuros de compatibilidade.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-compatibilidade-gutenberg-acf-pro/#faq-q7", "name": "Como saber se o problema e do ACF ou de outro plugin", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Desative os demais plugins um a um e troque para um tema padrão, recarregando o editor a cada teste. Se os campos e blocos voltarem, reative os itens até identificar o que interrompe a Block API.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```