Schema no WordPress: da instalação à validação sem erros no Search Console

Entender a teoria de marcação semântica é rápido. O que costuma travar é a etapa seguinte: colocar o código no site, conferir se o buscador leu corretamente e corrigir os avisos que aparecem depois. Saber como implementar dados estruturados no WordPress envolve três decisões, e nenhuma delas é sobre escrever código do zero.

A primeira é escolher entre plugin de SEO, plugin dedicado a marcação ou inserção manual. A segunda é decidir quais tipos de conteúdo realmente merecem marcação, porque marcar tudo não ajuda e pode gerar erro. A terceira é criar uma rotina de validação, já que os requisitos do Google mudam e o que passava ano passado pode virar aviso hoje. Se você ainda precisa entender o que é e por que isso importa, o guia sobre o que são dados estruturados cobre a base conceitual.

Como implementar dados estruturados no WordPress: três caminhos possíveis

A recomendação prática é começar pelo plugin de SEO que o site já usa. Quase todos geram automaticamente a marcação de artigo, de site e de trilha de navegação. Só depois, se algum tipo específico ficar de fora, vale acrescentar uma solução dedicada. O importante é não acumular duas fontes gerando a mesma marcação, porque o resultado é duplicidade e conflito.

Por que JSON-LD e não marcação dentro do HTML

O formato recomendado hoje pelo Google é o JSON-LD, um bloco de script separado do conteúdo visível. Ele é mais fácil de gerar, não depende da estrutura do tema e pode ser alterado sem mexer no layout. Marcações inseridas atributo por atributo dentro das tags continuam válidas, mas quebram com qualquer mudança de tema.

Quais tipos marcar em um site comum

A lista de tipos disponíveis em Schema.org é enorme, e a maior parte dela nunca gera nada visível no resultado de busca. Concentre esforço nos tipos que o Google usa para exibir recursos especiais:

• Artigo, para posts de blog e notícias.
• Perguntas frequentes, quando a página realmente traz pares de pergunta e resposta.
• Receita, com tempo de preparo, rendimento e ingredientes.
• Produto, com preço, disponibilidade e avaliações reais.
• Evento, com data, local e forma de participação.
• Organização e site, que ajudam a compor o painel de conhecimento e a caixa de busca interna.
• Trilha de navegação, que substitui a URL crua no resultado.

O formato Schema.org exige que o conteúdo marcado esteja visível na página. Marcar uma avaliação que não aparece para o visitante, ou um preço diferente do exibido, viola as diretrizes e pode custar a elegibilidade do site aos recursos visuais.

Rotina de validação em duas etapas

Validar uma vez não basta. O fluxo que funciona separa o teste pontual do acompanhamento contínuo.

1. Antes de publicar, cole a URL ou o código na Ferramenta de Teste de Resultados Ricos do Google. Ela mostra quais recursos a página se qualifica a exibir e aponta campos obrigatórios ausentes.
2. Depois de publicar, acompanhe os relatórios de aprimoramentos no Search Console. Eles processam o site inteiro ao longo dos dias e revelam problemas que um teste de página única não pega.
3. Trimestralmente, revise os avisos acumulados. Muitos surgem de mudanças de requisito, não de alterações que você fez.

Erro e aviso não são a mesma coisa

Erro significa campo obrigatório ausente: a página fica inelegível para o recurso. Aviso significa campo recomendado ausente: a página continua elegível, mas com menos chance de exibição rica. Priorizar os erros antes dos avisos economiza muito tempo em sites grandes.

Os problemas mais comuns em sites WordPress

• Marcação duplicada, quando o tema e o plugin geram o mesmo tipo. O teste mostra dois blocos concorrentes para a mesma página.
• Autor sem identificação adequada, um dos avisos mais frequentes em blogs.
• Imagem fora das proporções aceitas ou com resolução insuficiente para o recurso pretendido.
• Datas inconsistentes entre a marcação e o que o tema exibe.
• Perguntas frequentes marcadas em páginas sem perguntas visíveis, prática que já rendeu penalização manual em vários sites.
• Cache servindo versão antiga do bloco, o que faz a correção parecer ineficaz. Limpe o cache antes de revalidar.

O que muda quando você usa tipos personalizados

Sites com custom post types raramente recebem marcação automática adequada. Nesses casos, o caminho é gerar o bloco por função no tema filho, montando o objeto conforme a documentação do Schema.org e imprimindo o resultado no cabeçalho da página. A estrutura de chave e valor do JSON-LD torna isso relativamente simples, mesmo para quem tem pouca familiaridade com PHP.

Um cuidado vale para qualquer implementação manual: escape corretamente os valores antes de imprimir. Aspas não tratadas dentro de um título quebram o bloco inteiro e o buscador passa a ignorá-lo sem avisar. E sempre consulte a referência oficial do Schema.org para confirmar o nome exato de cada propriedade, porque abreviações inventadas simplesmente não são reconhecidas.

Outro hábito útil é manter uma página de referência aberta enquanto trabalha. A documentação do Schema.org lista os campos obrigatórios e opcionais de cada tipo, e conferir ali evita metade dos avisos antes mesmo do primeiro teste.

Quanto tempo leva para aparecer resultado

A marcação correta não garante exibição rica. Ela torna a página elegível, e a decisão final é do buscador. Após a validação, o rastreamento e o processamento costumam levar de alguns dias a algumas semanas, dependendo da frequência com que o site é visitado. Solicitar indexação no Search Console acelera páginas individuais, mas não resolve sites inteiros.

Perguntas frequentes

Preciso de plugin pago para marcar meu site?

Não. Os plugins de SEO gratuitos mais usados já geram as marcações essenciais. Soluções pagas fazem sentido quando o site depende de tipos específicos como produto ou evento.

Marcar mais tipos melhora o posicionamento?

Marcação não é fator de classificação direta. Ela influencia a apresentação do resultado, o que costuma melhorar a taxa de cliques, e isso sim tem efeito indireto.

Posso marcar avaliações do meu próprio produto?

Somente avaliações reais de usuários, visíveis na página. Avaliações inventadas ou autoatribuídas violam as diretrizes e podem gerar ação manual.

O que fazer quando o relatório aponta erro em páginas antigas?

Corrija o gerador da marcação, não página por página. Como o bloco é produzido pelo tema ou plugin, um ajuste central costuma resolver todas as ocorrências de uma vez.

Marcação de perguntas frequentes ainda vale a pena?

A exibição desse recurso foi bastante restringida nos resultados, mas a marcação continua válida e ajuda os sistemas a entenderem a página. Só não conte com o destaque visual.

Preciso remover a marcação antiga antes de instalar um plugin novo?

Sim, sempre que houver risco de duplicidade. Duas fontes gerando o mesmo tipo confundem o processamento e geram erros difíceis de rastrear.

O que levar dessa leitura

Saber como implementar dados estruturados no WordPress é escolher uma única fonte geradora, marcar apenas os tipos que o buscador realmente usa, validar antes de publicar e acompanhar os relatórios depois. A maior parte dos problemas não vem de código errado, e sim de duplicidade entre tema e plugin ou de conteúdo marcado que não existe na página visível. Resolva esses dois pontos e o resto vira manutenção trimestral.