Schema markup no WordPress: como adicionar do jeito certo
Por Toy Wen Da, Cofundador · Atualizado em · 7 min de leitura
Traduzido do original em inglês. Ler em inglês
O schema markup no WordPress é um dado estruturado, geralmente em JSON-LD, que diz ao Google e a outros mecanismos de busca sobre o que é uma página: uma receita, um produto, um FAQ ou uma empresa local. Escolha um plugin de SEO que já gere esse código para o seu tipo de conteúdo, ative-o e confira o resultado antes de editar qualquer coisa manualmente.
Antes de instalar qualquer coisa, veja o que falta na sua página hoje. O gerador gratuito de schema markup do SearchBlueprint cria JSON-LD válido para sete tipos comuns de schema: Article, Product, FAQ, Local Business, Review, Event e Organization. Cole o código no WordPress e compare com o que o seu plugin já gera.
O que o schema markup no WordPress realmente faz
O schema markup é um vocabulário padronizado, mantido pelo Schema.org. Ele rotula partes do seu conteúdo, como o autor, o preço, a avaliação em estrelas e as perguntas do FAQ, em um formato que as máquinas conseguem interpretar. Em um site WordPress, o código fica no HTML da página como um bloco de JSON-LD, invisível para os leitores, mas legível pelo Googlebot e por outros rastreadores.
Sozinho, ele não muda o seu posicionamento. Ele torna o seu conteúdo elegível para resultados de busca aprimorados: estrelas de avaliação abaixo de uma resenha, um acordeão de FAQ abaixo de um post de blog, uma linha com preço e disponibilidade abaixo de um produto. A documentação do Google sobre dados estruturados explica que esses rótulos ajudam os mecanismos de busca a entender o conteúdo da página, o que pode levar a recursos de exibição aprimorados nos resultados, e não a um impulso no ranqueamento (Google Search Central).
Para entender por que isso importa para o SEO, leia este detalhamento sobre o que o schema markup realmente faz pelo SEO. Ele entra nos mecanismos com mais profundidade do que este guia precisa.
Por que isso importa ainda mais agora
Mecanismos de resposta de IA, como os AI Overviews do Google, o ChatGPT e o Perplexity, se apoiam em dados estruturados para entender e citar páginas com precisão. Uma página com um schema markup limpo no WordPress oferece a esses sistemas uma fonte rotulada e sem ambiguidade para citar. Sem ele, a IA precisa adivinhar, e um palpite errado muitas vezes acaba na página de um concorrente.
Como corrigir o schema markup dentro do WordPress, passo a passo
A maioria dos sites não exige que você escreva nenhum código. Este é o caminho prático, em ordem.
Passo 1: escolha um plugin e fique com ele
Instale um plugin de SEO (Yoast SEO, Rank Math ou All in One SEO) e nada mais que também gere schema. Cada um adiciona seu próprio JSON-LD automaticamente a posts, páginas e produtos, de acordo com o tipo de conteúdo que você selecionar.
Passo 2: defina o tipo de conteúdo de cada página
No editor de posts ou páginas, role até o painel de configurações do plugin. O Yoast o chama de "Schema" e o Rank Math o chama de "Schema / Rich Snippet". Escolha o tipo que combina com a página: Article para um post de blog, Product para um item de loja, FAQ Page para um post de perguntas e respostas. Essa escolha determina quais campos o plugin pede que você preencha.
Passo 3: preencha os campos que o plugin oferece
A maioria dos plugins expõe alguns campos ligados a propriedades do schema, como nome do autor, data de publicação, nota da avaliação e pares de pergunta e resposta do FAQ. Preencha todos os campos que o plugin mostra para o tipo escolhido. Campos vazios significam marcação incompleta, e marcação incompleta pode custar o rich result mesmo quando o código tecnicamente é validado.
Passo 4: visualize o código gerado
O Yoast e o Rank Math permitem ver o schema bruto gerado antes de você publicar. Procure uma aba "Schema" ou "Structured Data" dentro do painel de SEO, abra-a e confira se o tipo, o nome e as propriedades principais combinam com o que está na página.
Passo 5: valide depois de publicar
Com a página no ar, passe-a pelo validador de schema gratuito do SearchBlueprint ou pelo Teste de Resultados Multimídia do Google (Rich Results Test). Corrija tudo o que for sinalizado como erro antes de passar para a próxima página.
Quando as ferramentas do próprio WordPress bastam e quando não bastam
Corrigir uma página por meio de um plugin é um problema diferente de corrigir o schema de um site inteiro, e o caminho gratuito só resolve bem o primeiro.
| Situação | O caminho gratuito/do plugin basta? | Por quê |
|---|---|---|
| Uma página com schema ausente ou quebrado | Sim | Corrija os campos do plugin nessa página, valide e pronto, em minutos |
| Um erro pontual depois de uma atualização de tema ou plugin | Sim | Em geral vem de um plugin em conflito ou de um problema de cache |
| O mesmo erro de schema se repete em dezenas ou centenas de URLs | Não | Indica um problema no template ou na configuração do plugin, que exige um rastreamento do site inteiro |
| O schema desapareceu do site inteiro depois de uma migração | Não | Provavelmente é um problema de reindexação em massa ou de reconstrução de templates, não uma correção página por página |
| Você tem um catálogo de e-commerce com milhares de produtos | Não | Verificações manuais página a página levam tempo demais nesse tamanho; faça auditorias automatizadas em intervalos regulares |
Se o seu problema está nas duas primeiras linhas, os passos acima resolvem hoje mesmo. Se está nas três últimas, você tem um problema recorrente no site inteiro, e auditorias contínuas vão ajudar mais do que correções pontuais. O relatório de SEO de exemplo do SearchBlueprint mostra como é esse tipo de visibilidade contínua na prática.
Como escolher o tipo de schema certo para o seu conteúdo
Nem toda página precisa do mesmo tipo de schema, e escolher o errado desperdiça esforço sem você perceber. A página de preços de uma empresa de SaaS precisa de uma marcação diferente da do blog, e, se você tem um site de software, este guia dos quatro tipos de schema para SaaS que vale implementar primeiro é melhor do que chutar.
Comparação de plugins
| Plugin | Tipos de schema cobertos | Edição manual de código | Ideal para |
|---|---|---|---|
| Yoast SEO | Article, Product, FAQ, How-To, Local Business, Breadcrumb | Limitada, por filtros | Sites de conteúdo e blogs em geral |
| Rank Math | Article, Product, FAQ, Review, Video, Recipe, Event e mais | Gerador de schema integrado com campos personalizados | Sites que precisam de uma gama maior de tipos de schema |
| All in One SEO | Article, Product, FAQ, Local Business, Software Application | Moderada, por templates de schema | Lojas WooCommerce e sites com vários tipos |
Erros comuns com schema markup no WordPress
- Usar dois plugins de schema ao mesmo tempo. O Yoast e o Rank Math injetam JSON-LD por padrão, então usar os dois duplica a marcação e pode confundir os rastreadores sobre qual versão vale.
- Deixar os campos de FAQ pela metade. Um bloco de schema de FAQ com três perguntas, mas só duas respostas, normalmente nem se qualifica para o rich result de FAQ, e as diretrizes de dados estruturados de FAQ do Google detalham os requisitos de completude.
- Esquecer de validar de novo depois de trocar o tema. Atualizações de tema às vezes removem ou alteram o schema injetado via functions.php.
- Adicionar schema que não corresponde ao conteúdo visível. Rotular uma página como Review quando nenhuma avaliação está visível nela viola as diretrizes de dados estruturados do Google e corre o risco de uma ação manual.
- Achar que o plugin resolve tudo. Os plugins geram o contêiner, mas você ainda precisa fornecer dados precisos e completos para cada campo.
Se você gera conteúdo de perguntas e respostas com ferramentas de IA, este guia sobre schema de FAQ gerado por IA mostra como manter a marcação precisa o bastante para que os mecanismos de IA a citem.
Perguntas frequentes
Preciso de um plugin para adicionar schema markup ao WordPress ou posso codificar por conta própria?
Um plugin basta para quase todos os sites. Escrever o JSON-LD à mão em um arquivo do tema dá mais controle, mas quebra com facilidade nas atualizações, por isso a maioria dos donos de site é mais bem atendida pelo Yoast, pelo Rank Math ou pelo All in One SEO.
Adicionar schema markup ao meu site WordPress garante rich results no Google?
Não. O schema markup torna a página elegível para rich results, mas não os garante. O Google continua decidindo se e quando mostrar um resultado aprimorado, com base nas próprias verificações de qualidade e relevância.
Dois plugins de SEO podem adicionar schema markup ao mesmo tempo?
Tecnicamente sim, mas você não deve permitir. Dois plugins que geram JSON-LD costumam produzir marcação duplicada ou conflitante, o que pode causar erros no validador ou levar o Google a ignorar os dois blocos.
Como verifico se o schema markup do meu WordPress está realmente funcionando?
Passe a página publicada por um validador de dados estruturados depois de publicar. Um campo que parece correto no editor do WordPress ainda pode falhar quando a página é renderizada, então o resultado no ar importa mais do que a prévia do editor.
O WooCommerce adiciona o schema de Product automaticamente?
O WooCommerce gera um schema de Product básico por padrão, mas a maioria dos plugins de SEO o amplia ou o substitui com campos como avaliações, disponibilidade e marca. Por isso, ainda vale a pena usar um plugin de SEO junto com o WooCommerce.
Valide antes de seguir em frente
Escolha um plugin, preencha todos os campos que ele pedir e valide a página no ar antes de considerar o trabalho concluído. Para a maioria dos sites WordPress, essa é a correção completa. Para ver exatamente o que está faltando, passe a página pelo gerador gratuito de schema markup antes de mexer nas configurações do plugin. Ele mostra o JSON-LD que a página deveria ter, então fica bem mais fácil identificar as lacunas no schema markup atual do seu WordPress.
Quando os erros de schema aparecem em mais do que um punhado de páginas, você já passou do ponto de uma correção em uma única página. Converse com a equipe sobre onde o schema markup do seu WordPress está quebrando no site inteiro.
Fontes
Sobre o autor
O SearchBlueprint pesquisou, escreveu e avaliou este artigo com o mesmo pipeline de conteúdo que nossos clientes usam nos próprios sites. A nota que aparece na assinatura é a que nosso mecanismo de conteúdo deu a esta página antes de ela ser publicada. Nada aqui passa por revisão manual, e esse é justamente o ponto: é o resultado do produto, publicado onde qualquer pessoa pode conferir.