--- title: "Como corrigir marcação inválida no Schema Generator do Rank Math" url: https://full.services/wp-fixer/corrigir-schema-generator-rank-math/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir marcação inválida no Schema Generator do Rank Math ## O que é a marcação inválida do Schema do Rank Math? O Schema Generator é o construtor de dados estruturados do Rank Math, na aba Schema do editor de posts. Ele monta o JSON-LD que descreve o conteúdo para o Google e habilita os resultados aprimorados, como estrelas de avaliação, FAQ e dados de produto. A marcação fica inválida quando viola as regras do Schema.org ou as exigências do Google: falta um campo obrigatório do tipo escolhido, uma propriedade foi colocada sob o grupo errado na hierarquia, uma variável dinâmica (como %title% ou %customfield(nome)%) retorna vazia, ou o valor está no formato errado. O Google rastreia a página, encontra o erro e ignora o rich snippet, mantendo o resultado comum. ## Como identificar - Na aba Code Validation do Schema Generator, o botão Test with Google retorna 'Campo obrigatório ausente' ou 'Valor inválido' para o tipo de schema. - No Teste de Resultados Aprimorados do Google aparece um erro de campo faltando (por exemplo author ou image em Article, price em Product). - No Search Console, o relatório de Aprimoramentos lista a página como 'inválida' para Artigo, Produto, FAQ ou Avaliação. - Os rich snippets (estrelas, FAQ, preço) sumiram da página nos resultados de busca, que voltou ao formato comum. - O Schema Markup Validator do Schema.org acusa dois blocos JSON-LD do mesmo @type na mesma URL. ## Como prevenir - Mantenha um único gerador de schema ativo: deixe o Rank Math gerar a marcação e desligue o schema nativo do tema e de outros plugins de SEO. - Sempre rode o Test with Google na aba Code Validation antes de publicar um post com schema personalizado. - Ao usar variáveis dinâmicas, confirme que o campo personalizado referenciado existe no tipo de post, para a variável não retornar vazia. - Acompanhe o relatório de Aprimoramentos no Search Console para pegar itens inválidos logo nos primeiros dias. Erros relacionados - [Como corrigir o schema de produto do Rank Math no WooCommerce](https://full.services/wp-fixer/corrigir-schema-produto-rank-math-woocommerce/) - [Como corrigir o schema de Local SEO no Rank Math](https://full.services/wp-fixer/corrigir-local-seo-rank-math/) - [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/) --- ## 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-schema-generator-rank-math/#article", "headline": "Como corrigir marcação inválida no Schema Generator do Rank Math", "url": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:31-03:00", "dateModified": "2026-06-17T12:39:46-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": "SEO Tecnico" } ], "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-schema-generator-rank-math/" }, "wordCount": 824, "description": "A marcação inválida no Schema do Rank Math ocorre quando o JSON-LD do Schema Generator tem campo obrigatório faltando, propriedade aninhada no grupo errado ou variável vazia, e o Google ignora o rich snippet. A causa mais comum é um campo exigido (autor, imagem) ausente ou um aggregateRating no grupo errado.", "articleSection": "SEO Tecnico", "keywords": "rank math campo obrigatorio ausente schema, rank math json-ld invalido, rank math schema duplicado, rank math schema generator erro, teste de resultados aprimorados rank math", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://rankmath.com/kb/schema-generator/", "name": "Rank Math — Custom Schema Generator" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir marcação inválida no Schema Generator do Rank Math", "programmingLanguage": "Json", "codeRepository": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq-q1", "name": "O que é o Schema Generator do Rank Math?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "É o construtor de dados estruturados do Rank Math, na aba Schema do editor de posts. Ele monta o JSON-LD que descreve o conteúdo para o Google e habilita rich snippets como estrelas, FAQ e dados de produto, sem você escrever o código à mão. A versão PRO permite criar schema personalizado e salvar templates.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq-q2", "name": "Por que o schema do Rank Math fica inválido?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque a marcação viola as regras do Google: falta um campo obrigatório do tipo, uma propriedade está aninhada no grupo errado, uma variável dinâmica retornou vazia ou o valor está no formato errado. O Google rastreia o JSON-LD, encontra o erro e ignora o rich snippet, deixando o resultado comum.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq-q3", "name": "Como descubro qual campo está quebrando o schema?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na aba Schema do post, abra a aba Code Validation e clique em Test with Google. O teste lista o tipo de schema e o campo exato com problema, como author ausente ou datePublished inválido. O Schema Markup Validator do Schema.org complementa, apontando erros de sintaxe e blocos duplicados.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq-q4", "name": "Por que meus rich snippets sumiram mesmo com o schema preenchido?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode haver schema duplicado: se o tema ou outro plugin de SEO também gera marcação, a página fica com dois blocos do mesmo tipo e o Google trata como erro. Outra causa é o schema declarar dados que não existem na página, como estrelas sem avaliações reais. Deixe só o Rank Math gerando o schema e remova claims sem lastro.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq-q5", "name": "O que significa o erro de propriedade aninhada no grupo errado?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Significa que uma propriedade foi colocada sob o grupo de schema errado na hierarquia do construtor. O caso mais comum é o aggregateRating dentro do grupo Review em vez do grupo Product, o que muda o significado da marcação. As linhas de hierarquia do Schema Generator mostram a quem cada propriedade pertence; basta movê-la para o grupo certo.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq-q6", "name": "Preciso editar JSON-LD à mão para corrigir?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Na maioria dos casos, não. O ajuste é feito no próprio Schema Generator: preencher os campos obrigatórios, corrigir o aninhamento e trocar variáveis vazias. Editar o JSON-LD diretamente só faz sentido em schema bem personalizado, e com cuidado para não duplicar a marcação que o Rank Math já gera.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-schema-generator-rank-math/#faq-q7", "name": "Depois de corrigir, quando os rich snippets voltam?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Depende de quando o Google rastrear a página de novo. Para acelerar, valide a correção no Test with Google e, no Search Console, use a Inspeção de URL e clique em Solicitar indexação. A volta dos snippets costuma levar de alguns dias a poucas semanas, e o Google ainda decide a exibição mesmo com schema válido.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```