Schema Markup no WordPress: como implementar rich snippets no Google
Quando você busca no Google e vê um resultado com estrelas de avaliação, uma FAQ expandível ou o preço de um produto, isso não é sorte — é Schema Markup funcionando.
Schema Markup (ou dados estruturados) é o código que diz ao Google exatamente o que significa o conteúdo da sua página. Sem ele, o Google interpreta o texto. Com ele, o Google entende que aquele conteúdo é uma receita, um produto, uma avaliação ou uma pergunta frequente — e pode exibir o resultado de forma visual e mais atraente.
Se o seu site WordPress já tem um SEO básico configurado e você quer ir além, Schema Markup é o próximo passo prático. Neste guia, você vai aprender o que é, como implementar com Rank Math ou Yoast, como validar e como evitar os erros mais comuns.
O que é Schema Markup (dados estruturados)
Schema Markup é um vocabulário padronizado de tags que você adiciona ao código HTML das suas páginas para descrever o conteúdo de forma semântica. Ele foi criado por uma colaboração entre Google, Bing, Yahoo e Yandex, e é mantido em schema.org.
Em termos práticos: o Schema Markup é uma etiqueta que você coloca na sua página dizendo ao Google “isto é um artigo”, “isto é uma receita com 30 minutos de preparo”, “este produto custa R$ 99 e tem 4,5 estrelas”.
Essa etiqueta não aparece visualmente para o visitante — ela fica no código-fonte da página, em formato que os mecanismos de busca conseguem ler automaticamente.
Por que Schema Markup importa para SEO
Dados estruturados não são um fator de ranking direto — ou seja, adicionar schema não vai, por si só, fazer seu site subir posições. Porém, eles impactam indiretamente o SEO de duas formas:
1. Rich snippets aumentam a taxa de clique (CTR). Quando seu resultado no Google aparece com estrelas, FAQ expandível ou preço, ele se destaca visualmente entre os outros resultados. Estudos de caso mostram que rich snippets podem aumentar significativamente a taxa de clique, dependendo do tipo e da posição.
2. Dados estruturados ajudam o Google a entender seu conteúdo. Quando o Google entende com precisão o que uma página significa, ele consegue associá-la melhor a buscas relevantes. Isso melhora a pertinência do resultado e pode influenciar indiretamente o posicionamento.
Além disso, o Google vem expandindo o uso de dados estruturados para novos recursos: resultados de voz no Google Assistente, painéis de conhecimento, carrosséis de receitas e muito mais. Quem implementa agora está se preparando para o futuro da busca.
Formatos: JSON-LD vs. Microdata vs. RDFa
Existem três formatos para implementar dados estruturados no HTML:
| Formato | Como funciona | Recomendação do Google |
|---|---|---|
| JSON-LD | Bloco de código <script> no <head> da página |
✅ Recomendado |
| Microdata | Atributos inline nas tags HTML existentes | Funcional, mas mais difícil de manter |
| RDFa | Atributos inline similares ao Microdata | Legado, raramente usado |
JSON-LD (JavaScript Object Notation for Linked Data) é o formato recomendado pelo Google e o que todos os plugins modernos de SEO usam. Ele tem vantagens claras:
- Fica em um bloco separado no
<head>, sem misturar com o conteúdo visível. - É mais fácil de gerar, editar e manter.
- É o formato que o Google consegue processar de forma mais confiável.
- Plugins como Rank Math e Yoast geram JSON-LD automaticamente.
Microdata e RDFa funcionam, mas exigem que você adicione atributos diretamente nas tags HTML do conteúdo — o que é mais trabalhoso e propenso a erros. Se você estiver usando um plugin de SEO, não precisa se preocupar com esses formatos.
Tipos de schema mais usados em sites WordPress
O vocabulário schema.org tem centenas de tipos, mas a maioria dos sites WordPress usa apenas alguns:
| Tipo de Schema | Quando usar | Exemplo visual no Google |
|---|---|---|
| Article (Article, BlogPosting, NewsArticle) | Posts de blog, notícias | Título + data + autor nos resultados |
| FAQPage | Páginas com perguntas e respostas | FAQs expandíveis abaixo do resultado |
| Product | Páginas de produto (WooCommerce) | Preço, disponibilidade, avaliação com estrelas |
| LocalBusiness | Sites de negócios locais | Endereço, horário, telefone nos resultados |
| Recipe | Sites de culinária | Foto, tempo de preparo, calorias, estrelas |
| HowTo | Tutoriais passo a passo | Passos visuais nos resultados |
| BreadcrumbList | Navegação estrutural | Breadcrumb (ex: Home > Categoria > Post) |
| VideoObject | Páginas com vídeos incorporados | Thumbnail do vídeo nos resultados |
| Event | Eventos com data e local | Data, local e horário nos resultados |
| JobPosting | Páginas de vagas de emprego | Título da vaga, empresa, localização |
Para a maioria dos sites WordPress, os schemas mais relevantes são Article (automático com qualquer plugin de SEO), FAQPage (para posts com FAQ), Product (para lojas WooCommerce) e LocalBusiness (para sites de negócios locais).
Schema automático: o que Rank Math e Yoast fazem sozinhos
Antes de configurar qualquer coisa, é importante saber o que já acontece automaticamente:
Rank Math (gratuito):
– Gera schema Article para posts e WebPage para páginas automaticamente.
– Gera BreadcrumbList se o módulo de breadcrumbs estiver ativo.
– Permite alterar o tipo de schema por post/página (Article, HowTo, FAQ, etc.).
– Oferece o tipo FAQBlock e HowTo na versão gratuita.
Yoast SEO (gratuito):
– Gera schema Article para posts e WebPage para páginas automaticamente.
– Gera BreadcrumbList se configurado.
– Gera Organization ou Person para o site.
– Na versão gratuita, oferece um bloco FAQ nativo no editor Gutenberg (gera o schema correspondente automaticamente), mas NÃO oferece schema Product ou Recipe — para esses tipos, é preciso um plugin complementar ou a versão premium.
Resumo: ambos os plugins cuidam do schema básico (Article, WebPage, BreadcrumbList) sem nenhuma configuração adicional. Mas para tipos específicos como Product, Recipe ou LocalBusiness, você precisa configurar manualmente ou usar recursos adicionais do plugin.
Como configurar schema com Rank Math (passo a passo)
Verificando se o schema automático está ativo
- No painel do WordPress, vá em Rank Math > Dashboard.
- Verifique se o módulo Schema (Structured Data) está ativo. Se não estiver, ative.
- Abra qualquer post publicado e inspecione o código-fonte (Ctrl+U no navegador) e busque por
application/ld+json. Se encontrar, o schema automático está funcionando.
Alterando o tipo de schema por post
- Abra o editor do post (Gutenberg ou clássico).
- Na barra lateral do Rank Math, clique na aba Schema.
- Você verá o schema padrão (Article). Para adicionar um tipo diferente, clique em Schema Generator.
- Escolha o tipo desejado (FAQ, HowTo, Product, etc.).
- Preencha os campos obrigatórios.
- Salve o post.
Adicionando schema FAQ com Rank Math
- No editor do post, vá para a aba Schema do Rank Math.
- Clique em Schema Generator e selecione FAQ.
- Preencha cada pergunta e resposta nos campos fornecidos.
- O Rank Math insere automaticamente o bloco FAQ no conteúdo (visível para o leitor) E gera o JSON-LD correspondente.
- Publique e valide com o Google Rich Results Test.
Dica: o Rank Math insere o FAQ como um bloco Gutenberg visível. Se quiser remover a exibição visual mas manter o schema, consulte a documentação do Rank Math — a versão PRO permite ocultar a exibição visual.
Adicionando schema de Produto com Rank Math
- Abra o produto no WooCommerce.
- Na aba Schema do Rank Math, altere o tipo para Product.
- Preencha: nome, descrição, marca, SKU, preço, moeda, disponibilidade.
- Se o produto tiver avaliações com estrelas, o Rank Math captura automaticamente se o WooCommerce estiver configurado para avaliações.
- Publique e valide.
Como configurar schema com Yoast SEO (passo a passo)
Verificando se o schema automático está ativo
- No painel, vá em Yoast SEO > Settings.
- Em Site Representation, verifique se o tipo de organização (Organization ou Person) está configurado.
- Em Content Types, verifique se os tipos de conteúdo (posts, páginas) têm schema ativo.
- Abra um post publicado e inspecione o código-fonte buscando por
application/ld+json.
Alterando o tipo de schema por post (Yoast)
- Abra o editor do post.
- Na barra lateral do Yoast, vá em Advanced (ícone de engrenagem).
- Em Schema page type, selecione o tipo desejado (Article, FAQ page, How-to, etc.).
- Em Schema article type, escolha entre Article, BlogPosting, NewsArticle, etc.
- Salve.
Limitação do Yoast gratuito: a alteração de tipo de schema por post é limitada. Para tipos avançados como Product ou Recipe, o Yoast gratuito depende de outro plugin ou de código manual. A versão Premium ou plugins complementares como o Yoast WooCommerce SEO expandem essa funcionalidade.
Adicionando schema FAQ com Yoast
O Yoast SEO gratuito oferece um bloco FAQ nativo no editor Gutenberg:
- No editor do post (Gutenberg), clique no botão + para adicionar um bloco.
- Busque por Yoast FAQ e selecione.
- Preencha cada pergunta e resposta.
- O bloco gera automaticamente o schema FAQPage correspondente.
- Publique e valide com o Google Rich Results Test.
Alternativa: se preferir não usar o bloco Yoast, você pode inserir o schema FAQ via JSON-LD manual (veja a seção de schema manual mais abaixo).
Como adicionar schema FAQ (com plugin e com código)
O schema FAQPage é um dos mais procurados porque exibe perguntas e respostas diretamente nos resultados do Google, ocupando mais espaço visual e atraindo mais cliques.
Com Rank Math (método mais simples)
- No editor do post, clique na aba Schema > Schema Generator > FAQ.
- Adicione cada pergunta e resposta.
- Publique e valide.
Com código manual (JSON-LD)
Se o seu plugin de SEO não suporta FAQ ou se você quer controle total, adicione o seguinte JSON-LD no <head> da página:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "O que é Schema Markup no WordPress?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Schema Markup é um código que você adiciona às páginas do WordPress para descrever o conteúdo de forma semântica ao Google, permitindo rich snippets como estrelas, FAQs e preços nos resultados de busca."
}
},
{
"@type": "Question",
"name": "Qual plugin de SEO gera schema automaticamente?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Rank Math e Yoast SEO geram schema Article e BreadcrumbList automaticamente. Para tipos como FAQ, Product e Recipe, o Rank Math oferece suporte nativo na versão gratuita."
}
}
]
}
</script>
Como inserir no WordPress:
- Opção 1: Use um plugin de inserção de código como WPCode — cole o JSON-LD no campo de header para a página específica.
- Opção 2: Edite o template do tema usando
wp_head— mas isso exige conhecimento de PHP e o schema ficará em todas as páginas (não recomendado para FAQ específico de uma página). - Opção 3: Use o Rank Math, que tem suporte nativo e é a opção mais simples.
Importante: sempre valide o JSON-LD com o Google Rich Results Test após inserir. JSON-LD com erros de sintaxe (vírgula faltando, aspas erradas) não será processado.
Como adicionar schema de Produto (WooCommerce)
Se você tem uma loja WooCommerce, o schema Product é essencial para exibir preço, disponibilidade e avaliação com estrelas nos resultados do Google.
Com Rank Math + WooCommerce
- Instale e ative o Rank Math (gratuito já oferece suporte a Product).
- Abra o produto no WooCommerce.
- Na aba Schema do Rank Math, selecione Product.
- Preencha: nome, descrição curta, marca, SKU, GTIN/ISBN (se disponível), preço, moeda (BRL), disponibilidade (InStock/OutOfStock).
- Se o WooCommerce tiver avaliações ativas, o Rank Math captura automaticamente a nota e o número de avaliações.
- Publique e valide.
Com Yoast + WooCommerce
- O Yoast SEO gratuito gera schema Product básico para produtos WooCommerce, incluindo preço, descrição e disponibilidade.
- Para controle avançado (marca, GTIN, avaliações customizadas), instale o plugin Yoast WooCommerce SEO (premium).
- Configure em Yoast SEO > Settings > WooCommerce.
Validando schema de Produto
Após publicar o produto:
- Acesse Google Rich Results Test.
- Cole a URL do produto.
- Verifique se os campos Product aparecem com todos os dados preenchidos.
- Atenção especial para:
price,priceCurrency,availability,review(se houver).
Como adicionar schema de Receita (Recipe)
Se você tem um site de culinária ou publica receitas, o schema Recipe permite que o Google exiba fotos, tempo de preparo, calorias e avaliações diretamente nos resultados.
Com Rank Math
- No editor do post, vá para Schema > Schema Generator.
- Selecione Recipe.
- Preencha: nome da receita, autor, data de publicação, descrição, imagem, tempo de preparo, tempo de cozimento, rendimento (porções), calorias, ingredientes e instruções.
- Publique e valide.
Com plugins específicos de receita
Plugins como WP Recipe Maker e Tasty Recipes são populares entre sites de culinária e geram schema Recipe automaticamente, além de oferecer layout visual para a receita no post. Se você já usa um desses plugins, provavelmente o schema já está sendo gerado — verifique com o Rich Results Test.
Cuidado: se Rank Math e um plugin de receita estiverem ativos simultaneamente, pode haver schema duplicado. Configure um ou outro, nunca ambos para o mesmo tipo de schema.
Como adicionar schema de Negócio Local (LocalBusiness)
Se você tem um negócio com endereço físico (restaurante, consultório, loja), o schema LocalBusiness pode exibir endereço, horário de funcionamento e telefone nos resultados do Google.
Com Rank Math
- Vá em Rank Math > Titles & Meta > Local SEO.
- Preencha: nome do negócio, endereço completo, telefone, horário de funcionamento, tipo de negócio (ex: Restaurant, LocalBusiness, MedicalBusiness).
- O Rank Math gera automaticamente o schema LocalBusiness para o site inteiro.
Com Yoast
- Vá em Yoast SEO > Settings > Site Representation.
- Em Organization or Person, selecione Organization.
- Preencha o endereço e dados do negócio.
- O Yoast gera o schema Organization (que o Google aceita como LocalBusiness quando os dados estão corretos).
Schema manual: quando e como usar JSON-LD puro
Existem situações em que o plugin de SEO não é suficiente:
- Você precisa de um tipo de schema que o plugin não suporta (ex: Course, SoftwareApplication, Book).
- Você quer adicionar schema a uma página específica sem alterar o schema global.
- Você tem um site personalizado com campos customizados e quer gerar schema dinamicamente.
Como inserir JSON-LD manualmente no WordPress
Opção 1 — Plugin WPCode (recomendado para maioria dos casos):
- Instale o plugin gratuito WPCode (anteriormente conhecido como Insert Headers and Footers).
- Vá em Code Snippets > Add Snippet > Add Your Custom Code (New Snippet).
- Selecione HTML Snippet.
- Cole o JSON-LD.
- Em Location, selecione Site Wide Header (para o site inteiro) ou configure para páginas específicas usando a opção Page-Specific.
- Ative o snippet.
Opção 2 — Função PHP no functions.php (avançado):
add_action('wp_head', function() {
if (is_page('minha-pagina')) {
?>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "Meu Negócio",
"address": {
"@type": "PostalAddress",
"streetAddress": "Rua Exemplo, 123",
"addressLocality": "São Paulo",
"addressRegion": "SP",
"postalCode": "01000-000",
"addressCountry": "BR"
},
"telephone": "+55-11-99999-9999"
}
</script>
<?php
}
});
Cuidado ao editar functions.php:
- Sempre usar um tema filho — alterações no functions.php do tema pai serão perdidas na atualização.
- Fazer backup antes de qualquer alteração. Erros de sintaxe PHP podem quebrar o site (tela branca).
- Testar em staging se possível.
Como validar com Google Rich Results Test
Após implementar qualquer schema, a validação é obrigatória. O Google oferece a ferramenta gratuita Rich Results Test:
- Acesse https://search.google.com/test/rich-results.
- Cole a URL da página (ou o código JSON-LD).
- Clique em Testar URL.
- A ferramenta mostra:
- Rich results detected: quais tipos de rich snippet o Google consegue extrair (FAQ, Product, Recipe, etc.).
- Errors: problemas que impedem o schema de ser processado.
- Warnings: campos opcionais que estão faltando (não impedem o processamento, mas melhoram a qualidade).
Diferença entre erros e warnings
- Erro (vermelho): campo obrigatório ausente ou inválido. O Google NÃO vai gerar rich snippet. Corrija antes de publicar.
- Warning (amarelo): campo opcional ausente. O Google PODE gerar o rich snippet, mas com menos dados. Recomendado preencher quando possível.
Validando em massa
Para validar todas as páginas do site, use o Google Search Console (veja a próxima seção). O Rich Results Test é para páginas individuais; o Search Console mostra o panorama completo.
Como monitorar no Google Search Console
O Google Search Console mostra como o Google vê os dados estruturados do seu site:
- Acesse Google Search Console.
- No menu lateral, em Aprimoramentos (ou Enhancements), você verá os tipos de schema detectados: FAQ, Product, Review snippet, etc.
- Clique em cada tipo para ver:
- Páginas válidas (sem erros).
- Páginas com warnings.
- Páginas com erros.
- Clique em cada erro para ver as páginas afetadas e o motivo.
- Após corrigir, clique em Validar correção para que o Google reavalie.
Frequência recomendada: verificar o Search Console pelo menos uma vez por semana se você publica conteúdo regularmente, ou após grandes mudanças no site (novo tema, novo plugin, migração).
Erros comuns de schema e como corrigir
| Erro | Causa | Correção |
|---|---|---|
| Missing field “image” | Schema Article ou Product sem imagem | Defina a imagem destacada ou preencha o campo de imagem no schema |
| Missing field “datePublished” | Post sem data | Verifique se o post tem data de publicação |
| Duplicate schema | Rank Math + outro plugin gerando schema para a mesma página | Desative o schema de um dos plugins |
| Invalid JSON-LD syntax | Erro de sintaxe no código manual (vírgula, aspas, chaves) | Valide o JSON com jsonlint.com antes de inserir |
| priceCurrency missing | Schema Product sem moeda | Preencha o campo de moeda (BRL para Real brasileiro) |
| Unspecified type | Schema sem @type definido | Verifique se o JSON-LD tem “@type” correto |
| Mismatched content | Schema descreve algo diferente do conteúdo visível | Garanta que o schema reflita o conteúdo real da página |
Importante: nunca insira dados falsos no schema. Avaliações inventadas, preços errados ou informações enganosas violam as diretrizes do Google para dados estruturados e podem resultar em ação manual (penalização).
FAQ
O que é Schema Markup no WordPress?
Schema Markup é um código (dados estruturados) que você adiciona às páginas do WordPress para descrever o conteúdo de forma semântica ao Google. Quando implementado corretamente, permite que o Google exiba rich snippets nos resultados — como estrelas de avaliação, FAQs expandíveis, preços de produtos e muito mais.
Qual é o melhor plugin de schema para WordPress?
Para a maioria dos sites, o plugin de SEO já resolve. Rank Math oferece suporte nativo a múltiplos tipos de schema (Article, FAQ, HowTo, Product) na versão gratuita. Yoast SEO gera schema básico automaticamente e tem um bloco FAQ nativo no Gutenberg, mas tipos avançados como Product e Recipe podem precisar de plugin complementar ou versão premium. Para sites de receitas, WP Recipe Maker é a opção mais popular.
JSON-LD ou Microdata: qual usar?
Use JSON-LD. É o formato recomendado pelo Google, é mais fácil de manter e é o que todos os plugins modernos de SEO geram. Microdata funciona, mas é mais trabalhoso e propenso a erros.
Rich snippets aparecem automaticamente após implementar schema?
Não. O Google decide quando exibir rich snippets com base na qualidade do schema, na relevância da página e em outros fatores. Implementar o schema é o pré-requisito, mas a exibição depende do Google. Pode levar dias ou semanas após a implementação.
Como saber se meu site já tem schema?
Abra qualquer página do seu site no navegador, pressione Ctrl+U para ver o código-fonte e busque por application/ld+json. Se encontrar blocos com esse tipo, seu site já tem schema. Também pode usar o Google Rich Results Test para verificar uma URL específica.
Posso ter schema duplicado no mesmo site?
Não é recomendado. Se Rank Math e outro plugin gerarem schema para a mesma página, o Google pode confundir ou ignorar um dos schemas. Use um único plugin por tipo de schema.
Schema Markup é obrigatório para SEO?
Não é obrigatório, mas é altamente recomendado. Sites sem schema funcionam normalmente no Google, mas perdem a oportunidade de exibir rich snippets que aumentam a visibilidade e a taxa de clique.
Quanto tempo leva para os rich snippets aparecerem?
Varia. Pode levar de alguns dias a algumas semanas após a implementação e indexação da página. O Google precisa recrawlar a página, processar o schema e decidir se o rich snippet é apropriado. Monitorar pelo Search Console é a melhor forma de acompanhar.
Conclusão
Schema Markup não é mais um diferencial opcional — é parte fundamental de uma estratégia de SEO WordPress completa. Com plugins como Rank Math e Yoast, a implementação básica é acessível mesmo para quem não programa. E para tipos de schema mais específicos como FAQ, Product e Recipe, a configuração leva poucos minutos e pode transformar a aparência dos seus resultados no Google.
O processo é simples:
- Verifique se seu plugin de SEO já gera schema automático.
- Configure tipos específicos (FAQ, Product, Recipe, LocalBusiness) conforme a necessidade.
- Valide com o Google Rich Results Test.
- Monitore pelo Search Console.
Se você já cuidou do básico de SEO no WordPress e quer extrair mais dos seus resultados no Google, Schema Markup é o próximo passo lógico — e agora você tem o roteiro completo para implementar.



