SEOPress schema invalido: como corrigir o erro

Tipo SEO Tecnico

Nome do erro Schema markup inválido no SEOPress EN: SEOPress invalid schema markup

Severidade Atenção

Descrição O erro de schema markup no SEOPress acontece quando o JSON-LD gerado pelo módulo Structured Data Types fica sem uma propriedade obrigatoria, recebe um campo dinâmico vazio ou e duplicado por outro plugin, e o Google deixa de usar a marcacao.

O que é erro de schema markup no SEOPress?

Schema markup no SEOPress e o JSON-LD que o plugin injeta no cabeçalho da página pelo módulo Structured Data Types, descrevendo o conteúdo (Article, FAQ, Product, LocalBusiness) para os buscadores. O erro de schema invalido aparece quando esse JSON-LD não segue o vocabulario do schema.org: falta uma propriedade que o Google marca como obrigatoria, um campo dinâmico aponta para um valor que não existe no post, ou duas marcacoes do mesmo tipo são emitidas na mesma URL. Quando isso ocorre, o Google ignora a marcacao e a página perde o rich result, mesmo que o conteúdo esteja correto.

Como identificar

No Google Search Console, em Aprimoramentos, aparece a mensagem ‘Campo obrigatório ausente’ ou ‘Campo X ausente (opcional)’ para a URL.
No Rich Results Test (search.google.com/test/rich-results) o item aparece com ‘Erro’ em vermelho e a propriedade faltante listada abaixo do tipo.
No Schema.org Validator (validator.schema.org) o mesmo tipo de schema aparece duas vezes para a URL, sinalizando marcacao duplicada.
A página perde o rich snippet (estrelas, FAQ sanfonada, breadcrumb) que antes exibia na SERP.
Após editar um schema automático em SEO -> Schemas, a alteração não reflete no código-fonte da página porque o cache não foi limpo.

Como prevenir

Mantenha apenas um gerador de schema ativo por site: escolha SEOPress ou outro plugin de SEO, nunca os dois emitindo o mesmo tipo.
Em lojas WooCommerce, desative o JSON-LD padrão do WooCommerce assim que ativar o schema Product do SEOPress.
Antes de publicar um tipo de schema novo, valide um post de amostra no Rich Results Test e so depois aplique o schema automático ao tipo de post inteiro.
Garanta que todo post que recebe schema Article tenha imagem destacada e autor definidos, para não gerar propriedade obrigatoria vazia.
Acompanhe o relatório de Aprimoramentos do Search Console periodicamente para pegar erros novos antes que afetem o rich result.

Causa

Uma propriedade obrigatoria do tipo escolhido não foi preenchida: por exemplo, um schema Article sem image ou sem author, ou um Product sem offers. Sem o valor obrigatório o Google não usa a marcacao.
Um campo dinâmico do schema automático aponta para um dado que aquele post não tem (a imagem destacada esta vazia, ou a variavel mapeada não retorna valor), entao a propriedade sai como string vazia no JSON-LD.
Schema duplicado: o tema, o WooCommerce (JSON-LD padrão do Product) ou outro plugin de SEO como o Rank Math emite o mesmo tipo na mesma URL, e os dois blocos conflitam no Rich Results Test.
O JSON-LD padrão do WooCommerce continua ativo junto com o schema Product do SEOPress, gerando dois Product incompletos na página de produto.
Um schema manual aplicado em SEO -> Schemas com condicao 'Show this schema if is' ampla demais (todo o site) sobrepoe o schema correto de tipos especificos de post.
O cache de página ou de objeto servindo uma versão antiga da URL, exibindo o JSON-LD anterior ao ajuste feito no metabox Structured Data Types.

Como resolver

Identifique o tipo e a propriedade que falham: Rode a URL no Rich Results Test do Google e anote exatamente qual tipo de schema esta em erro e qual propriedade aparece como ausente. Esse e o alvo da correção, não reescreva o schema inteiro.
```
https://search.google.com/test/rich-results
```
Confirme se ha schema duplicado: Cole a mesma URL no Schema.org Validator. Se o mesmo tipo (por exemplo Article ou Product) aparecer duas vezes, a causa e duplicacao, e a correção e remover a fonte extra, não editar o SEOPress.
```
https://validator.schema.org
```
Localize o schema no SEOPress: No painel, abra o módulo de schema para ver se a marcacao em erro vem de um schema automático (global por tipo de post) ou de um schema manual aplicado naquele post pelo metabox.
```
SEO -> PRO -> Structured Data Types (schema.org)
SEO -> Schemas
Editar o post -> metabox Structured Data Types
```
Preencha a propriedade obrigatoria ou corrija o campo dinâmico: Se a falha for propriedade ausente, defina um valor para ela no schema. Se for campo dinâmico vazio, troque a fonte da variavel ou cadastre o dado no post (por exemplo, defina a imagem destacada para alimentar a propriedade image).
```
Defina a imagem destacada do post para preencher image
Mapeie author para 'Manual text on each post' quando a variavel vier vazia
```
Elimine a duplicacao na fonte: Quando o duplicado vier do WooCommerce, desative o JSON-LD padrão dele para deixar so o schema do SEOPress. Quando vier de outro plugin de SEO ativo no mesmo site, desligue a saida de schema de um dos dois para não manter dois geradores no ar.
```
SEO -> PRO -> WooCommerce -> marcar 'Remove default JSON-LD structured data (WooCommerce 3+)'
```
Limpe o cache e revalide: Salve, limpe o cache de página e de objeto e rode a URL de novo no Rich Results Test até o erro sumir. No Search Console, peca a validação da correção no relatório de Aprimoramentos e aguarde, pois pode levar dias.
```
Limpar cache do plugin de cache e do CDN
Search Console -> Aprimoramentos -> Validar correção
```

PHP

add_filter( 'seopress_pro_schemas_auto_article', function ( $schema ) {
    // garante a propriedade obrigatoria 'image' quando o post nao tem imagem destacada
    if ( empty( $schema['image'] ) ) {
        $schema['image'] = 'https://exemplo.com.br/wp-content/uploads/logo-fallback.png';
    }
    // garante 'author' quando a variavel dinamica retorna vazia
    if ( empty( $schema['author'] ) ) {
        $schema['author'] = array(
            '@type' => 'Person',
            'name'  => get_the_author_meta( 'display_name', get_post_field( 'post_author', get_the_ID() ) ),
        );
    }
    return $schema;
} );

Perguntas frequentes

Por que o Google diz que o schema do SEOPress esta invalido se a página abre normal?

Porque a validade do schema independe do conteúdo visivel. O JSON-LD pode estar sem uma propriedade obrigatoria ou com um campo vazio, e o Google so olha esse código. A página abre, mas a marcacao e descartada e o rich result some.

Qual a diferenca entre propriedade obrigatoria e recomendada no schema do SEOPress?

A obrigatoria precisa de valor ou o Google ignora a marcacao inteira. A recomendada melhora a apresentação, mas a ausencia dela so gera um aviso, não um erro. No Rich Results Test, obrigatoria aparece como Erro em vermelho e recomendada como Aviso.

O erro vem de schema duplicado entre SEOPress e outro plugin?

Pode vir. Se o tema, o WooCommerce ou outro plugin de SEO emitir o mesmo tipo na mesma URL, os dois blocos conflitam. Valide a URL no Schema.org Validator: se o tipo aparecer duas vezes, desative a saida de schema de uma das fontes.

Como valido o schema do SEOPress depois de corrigir?

Rode a URL no Rich Results Test do Google e no Schema.org Validator. O primeiro mostra se o tipo gera rich result e quais campos faltam. O segundo confirma se não ha duplicacao. So considere resolvido quando os dois ficarem sem erro.

Editei o schema no SEOPress mas o erro continua. O que falta?

Quase sempre e cache. O SEOPress injeta o JSON-LD no carregamento da página, entao o cache de página e de CDN servem a versão antiga. Limpe os dois e revalide. Se persistir, confirme que você editou o schema certo, automático ou manual.

Preciso saber programar para corrigir schema invalido no SEOPress?

Na maioria dos casos não. Preencher a propriedade que falta, corrigir o campo dinâmico e desativar a duplicacao são feitos pelo painel. Código so e necessário para adicionar propriedades que o painel não expoe, via filtro do plugin no functions.php.

O schema Product do WooCommerce conflita com o do SEOPress?

Sim, se os dois estiverem ativos. O WooCommerce emite um JSON-LD Product padrão e o SEOPress emite outro, gerando dois Product incompletos. Ative em SEO -> PRO -> WooCommerce a opção de remover o JSON-LD padrão do WooCommerce e mantenha so o do SEOPress.

Atenção

Como corrigir o FAQ Schema do Rank Math que não valida

O Rank Math FAQ Schema não valida quando algum par pergunta/resposta fica vazio, quando o bloco FAQ não é renderizado no conteúdo público da página, ou quando o cache serve uma versão antiga sem o bloco. O markup só sai como FAQPage se cada item tiver pergunta e resposta preenchidas.

Atenção

Como corrigir o erro de Open Graph no SEOPress

O erro de Open Graph no SEOPress acontece quando o plugin não emite as tags og:title, og:description e og:image, entao a previa do link sai sem imagem ou com título errado no Facebook e no WhatsApp. As causas comuns são o Open Graph desativado em Social Networks, a falta de imagem destacada ou padrão, ou outro plugin duplicando a tag.

Atenção

Como corrigir a lentidão do SEOPress no painel do WordPress

O SEOPress lento no dashboard acontece quando módulos de coleta de dados como Insights, Site Audit, 404 Monitor e Broken Link Checker acumulam registros no banco e disparam consultas pesadas a cada carregamento do painel. Desativar os módulos que você não usa e limpar as tabelas de dados restaura a velocidade do dashboard.

Atenção

Como corrigir o sitemap duplicado entre Rank Math, SEOPress e Yoast

O sitemap duplicado Rank Math, SEOPress e Yoast ocorre quando mais de um plugin de SEO fica ativo e cada um registra a rota sitemap_index.xml. O resultado são duas versões do mesmo sitemap na mesma URL, sitemaps órfãos no Search Console e indexação inconsistente. A correção é manter um único gerador de sitemap ativo.

Grave

Como corrigir o sitemap do Rank Math que não submete ao Google Search Console

O Search Console rejeita o sitemap do Rank Math na submissão quando o sitemap_index.xml devolve 404, HTML, redirecionamento ou um arquivo estático no disco no lugar do XML virtual. A URL só é aceita depois que a rota, o cache e o robots.txt liberam o XML puro.

Grave

Como corrigir o schema de produto do Rank Math no WooCommerce

O schema de produto do Rank Math no WooCommerce fica invalido quando o markup sai sem offers, review ou aggregateRating, quando aparece em páginas de arquivo, ou quando o WooCommerce duplica a marcacao Product.

Setores

Extensões

Integrações

Como corrigir o erro de schema markup no SEOPress

O que é erro de schema markup no SEOPress?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o FAQ Schema do Rank Math que não valida

Como corrigir o erro de Open Graph no SEOPress

Como corrigir a lentidão do SEOPress no painel do WordPress

Como corrigir o sitemap duplicado entre Rank Math, SEOPress e Yoast

Como corrigir o sitemap do Rank Math que não submete ao Google Search Console

Como corrigir o schema de produto do Rank Math no WooCommerce

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos