--- title: "Como corrigir scripts que não carregam pelo Script Manager do Perfmatters" url: https://full.services/wp-fixer/corrigir-script-manager-perfmatters/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir scripts que não carregam pelo Script Manager do Perfmatters ## O que é o Perfmatters Script Manager JS não carrega? O Script Manager do Perfmatters é a ferramenta que lista cada arquivo JavaScript e CSS enfileirado em uma página do front-end e permite marcar cada um como On (carrega) ou Off (não carrega), com escopo Everywhere, Current URL, por tipo de post ou por Regex. Ele serve para cortar requisições desnecessárias e acelerar páginas como a home, sem editar código. O problema aparece quando um script é desativado em escopo amplo e não há exceção para a página que de fato depende dele. Como o Perfmatters remove o enfileiramento antes de o WordPress imprimir o arquivo, o navegador nunca baixa o JavaScript, qualquer recurso que dependia dele (sliders, formulários, abas, contadores) para de funcionar e o console acusa funções ou variáveis indefinidas. O Script Manager atua só no front-end, então o painel do WordPress não mostra erro: o recurso segue ativo, apenas o arquivo não chega ao usuário. ## Como identificar - Um recurso visual para de responder no front-end (slider parado, abas que não trocam, formulário que não envia), mas a funcionalidade continua ativa no painel do WordPress. - O console do navegador mostra erro do tipo "Uncaught ReferenceError: $ is not defined" ou "function is not defined", apontando para um script que deixou de ser carregado. - Na aba Network do DevTools o arquivo .js do plugin ou tema some da lista de requisições só nas páginas afetadas. - Ao abrir o Script Manager pela barra de administração, o script aparece com Status Off em Everywhere ou no tipo de post da página, sem exceção marcada. - Ao tentar salvar uma alteração no Script Manager surge a mensagem "Settings failed to update". ## Como prevenir - Ative o Testing Mode do Script Manager para que suas alterações só valham para administradores logados até você confirmar que nada quebrou no front-end - Desative scripts um a um e teste a página a cada mudança, em vez de desligar vários de uma vez, já que o Script Manager permite reverter a última alteração - Prefira desativar em Everywhere com exceção em Current URL nas páginas que usam o recurso, em vez de depender de exceções por tipo de post que podem não cobrir a URL exata - Antes de aplicar em produção, valide a configuração em um ambiente de staging para não derrubar funcionalidade em páginas de alto tráfego Erros relacionados - [Como corrigir funcionalidades quebradas pelo Perfmatters](https://full.services/wp-fixer/corrigir-funcionalidades-quebradas-perfmatters/) - [Como corrigir o conflito de JavaScript entre Perfmatters e Elementor](https://full.services/wp-fixer/corrigir-conflito-js-perfmatters-elementor/) - [Como corrigir scripts essenciais do WooCommerce removidos pelo Perfmatters](https://full.services/wp-fixer/corrigir-scripts-woocommerce-perfmatters/) --- ## 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-script-manager-perfmatters/#article", "headline": "Como corrigir scripts que não carregam pelo Script Manager do Perfmatters", "url": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:31-03:00", "dateModified": "2026-06-17T12:39:31-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": "Performance & Velocidade" } ], "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-script-manager-perfmatters/" }, "wordCount": 855, "description": "No Perfmatters Script Manager o JS não carrega quando um arquivo JavaScript enfileirado é marcado como Off em escopo amplo (Everywhere ou por tipo de post) sem exceção para a página que precisa dele. O script some do front-end e a funcionalidade que dependia daquele arquivo para de responder, embora o recurso continue ativo no painel.", "articleSection": "Performance & Velocidade", "keywords": "perfmatters desabilitou script necessario, perfmatters everywhere excecao current url, perfmatters script manager quebrou funcionalidade, perfmatters settings failed to update, reativar script perfmatters", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://perfmatters.io/docs/disable-scripts-per-post-page/", "name": "Perfmatters — How to disable scripts on a per post/page basis (Script Manager)" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir scripts que não carregam pelo Script Manager do Perfmatters", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q1", "name": "Por que o JavaScript não carrega depois que mexi no Script Manager do Perfmatters", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque um arquivo JavaScript enfileirado foi marcado como Off em escopo amplo, como Everywhere ou por tipo de post, sem exceção para a página que precisa dele. O Perfmatters remove o enfileiramento antes de o WordPress imprimir o arquivo, então o navegador nunca baixa o script e o recurso que dependia dele para de funcionar.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q2", "name": "Como reativar um script desativado no Perfmatters sem perder a otimização", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Abra o Script Manager na página afetada, localize o arquivo e, em vez de mudar o Status para On em todo lugar, mantenha Off em Everywhere e adicione uma exceção em Current URL para esta página. Assim o script volta só onde é necessário e a economia geral continua valendo no resto do site.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q3", "name": "Onde fica o Script Manager do Perfmatters", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Ele não aparece no painel do WordPress nem na tela de configurações do plugin. Você precisa navegar até uma página do front-end e abri-lo pela barra de administração, no menu Perfmatters, ou anexar o parâmetro perfmatters ao fim da URL da página. A ferramenta sempre lista os scripts da página que está sendo exibida.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q4", "name": "O que significa o erro Settings failed to update no Script Manager", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Quase sempre significa que você tentou salvar uma desativação sem escolher um escopo sob Disabled, como Everywhere, Current URL ou Regex. Sem escopo, o plugin não sabe onde aplicar e recusa a gravação. Causas mais raras são conflito com outro plugin que estiliza inputs ou um erro de JavaScript em cascata visível no console.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q5", "name": "O Script Manager pode quebrar funcionalidades do WooCommerce ou de formulários", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode, se você desativar o arquivo JavaScript de que esses recursos dependem em uma página onde eles são usados. Formulários, checkout e sliders costumam depender de scripts próprios. Por isso desative com exceção na URL que usa o recurso e teste o envio ou a compra antes de aplicar em produção.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q6", "name": "Por que um script não aparece na lista do Script Manager", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Em geral porque ele não foi enfileirado corretamente no WordPress pelo desenvolvedor do plugin ou tema, ou porque é uma declaração font-face dentro de um arquivo CSS, que não passa pela fila de scripts. O Script Manager só controla o que está devidamente enfileirado no front-end, então arquivos hardcoded não aparecem.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q7", "name": "Desativei por mobile e o script some e volta sozinho, por quê", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "A desativação por device do Perfmatters depende de cache separado por dispositivo, porque ele usa a função que detecta mobile do WordPress. Sem buckets de cache distintos para desktop e mobile, o servidor entrega a mesma página para os dois e o script aparece ou some conforme a versão em cache. Ative o cache mobile no host ou no plugin de cache.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-script-manager-perfmatters/#faq-q8", "name": "As alterações do Script Manager são permanentes", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não. O Script Manager não altera os arquivos do plugin ou do tema, apenas controla o enfileiramento. Você pode reverter a última alteração, mudar o Status de volta para On ou remover a desativação na Global View para retornar tudo ao estado original sem risco de dano permanente.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```