--- title: "Como corrigir rich snippets inválidos no Schema do WordPress" url: https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir rich snippets inválidos no Schema do WordPress ## O que é rich snippets schema inválido? Rich snippets schema inválido acontece quando o WordPress entrega a marcação estruturada (JSON-LD) na página, porém o Google a considera incompleta ou malformada e descarta a elegibilidade para resultado rico. A documentação do Rank Math é explícita: ter o Schema certo importa mais do que apenas ter Schema, e uma marcação errada ou incompleta faz o Google não considerar a página para rich results. Diferente de schema ausente, aqui o código está presente e até pode parecer correto no editor, mas falha na validação oficial do Rich Results Test por um campo obrigatório faltando, um tipo de dado trocado ou aninhamento errado das propriedades. ## Como identificar - No Rich Results Test (search.google.com/test/rich-results) aparece a mensagem 'Campo obrigatório ausente' ou 'Missing field' apontando uma propriedade do Schema - Na aba Code Validation do Schema Generator do Rank Math, ao clicar em 'Test with Google', o resultado mostra erros em vermelho em vez de 'Página elegível para resultados avançados' - No Google Search Console, em Aprimoramentos, o item do tipo de schema aparece com status 'Inválido' e contador de itens com erro - O snippet rico (estrelas, FAQ, breadcrumb, preço) some da SERP mesmo dias depois da publicação, exibindo só o resultado azul padrão - O validator.schema.org acusa 'A value for the X property is required' ou 'X is not a known property of type Y' ## Como prevenir - Escolha o tipo de schema que casa com o conteúdo (Article para post, Product para produto, FAQPage só com pares reais de pergunta e resposta) antes de publicar - Rode o Rich Results Test em toda página nova ou alterada e só publique quando o resultado indicar elegibilidade, sem campos obrigatórios faltando - Mantenha uma única fonte de schema por tipo, desativando a marcação do tema quando o Rank Math já cobre aquele tipo, para evitar blocos duplicados - Acompanhe o relatório de Aprimoramentos do Search Console semanalmente para pegar itens marcados como Inválido logo após cada deploy - Ao usar variáveis do Schema Generator, confira que os custom fields referenciados existem e estão preenchidos antes de salvar o post Erros relacionados - [Como corrigir marcação inválida no Schema Generator do Rank Math](https://full.services/wp-fixer/corrigir-schema-generator-rank-math/) - [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/) - [Como corrigir o FAQ Schema do Rank Math que não valida](https://full.services/wp-fixer/corrigir-faq-schema-rank-math/) --- ## 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-rich-snippets-schema-invalido/#article", "headline": "Como corrigir rich snippets inválidos no Schema do WordPress", "url": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/", "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-rich-snippets-schema-invalido/" }, "wordCount": 910, "description": "Rich snippets schema inválido é quando a marcação JSON-LD da página existe, mas o Rich Results Test do Google a rejeita por campo obrigatório ausente ou tipo incorreto, então o resultado rico nunca aparece na busca.", "articleSection": "SEO Tecnico", "keywords": "rich results test erro rank math, rich snippets schema invalido rank math, schema markup nao valida wordpress, structured data missing field wordpress", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://rankmath.com/kb/rich-snippets/", "name": "Rank Math — Rich Snippets (KB)" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir rich snippets inválidos no Schema do WordPress", "programmingLanguage": "HTML", "codeRepository": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq-q1", "name": "Por que meu rich snippet some mesmo com o schema na página?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Porque presença não é validade. Se o Rich Results Test acusa um campo obrigatório ausente ou um tipo de dado errado, o Google descarta a elegibilidade e exibe só o resultado padrão, mesmo com o JSON-LD presente na página.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq-q2", "name": "Como saber qual campo do schema está inválido?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Cole a URL pública no Rich Results Test do Google. Ele lista cada erro em vermelho nomeando a propriedade e o tipo de schema, por exemplo 'Missing field image' em Article, o que aponta exatamente o que preencher no Schema Generator.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq-q3", "name": "Schema duplicado entre tema e Rank Math quebra o rich snippet?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Quando o tema emite a própria marcação além da do Rank Math, a página fica com dois blocos JSON-LD do mesmo tipo e o parser do Google pode rejeitar ou ignorar ambos. Mantenha apenas uma fonte de schema por tipo.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq-q4", "name": "Quanto tempo o rich snippet leva para voltar depois da correção?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não é imediato. Mesmo com o schema válido, o Google só reconsidera a página para resultado rico após um novo crawl. Solicitar indexação no Search Console acelera, mas a volta do snippet costuma levar de horas a alguns dias.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq-q5", "name": "FAQPage e Article pedem as mesmas propriedades obrigatórias?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não. Cada tipo tem campos próprios: Article exige headline e geralmente image, FAQPage exige pares de pergunta e resposta reais visíveis na página. Usar o tipo errado para o conteúdo gera incompatibilidade e reprovação no teste.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq-q6", "name": "Por que aparece %title% literal no meu JSON-LD?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "A variável do Schema Generator não resolveu. Isso ocorre quando o custom field referenciado está vazio ou tem nome diferente. Confira a variável na aba Code Validation e aponte para um campo que exista e esteja preenchido.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-rich-snippets-schema-invalido/#faq-q7", "name": "Validar pelo validator.schema.org é o mesmo que o Rich Results Test?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não são equivalentes. O validator.schema.org checa a sintaxe contra o vocabulário Schema.org, enquanto o Rich Results Test verifica os requisitos específicos do Google para resultado rico. Use o do Google para elegibilidade e o Schema.org para tipos que o Google não cobre.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```