Uma página fala com dois leitores. A pessoa lê o texto. O buscador lê o código e tenta adivinhar o que cada pedaço quer dizer: isto é um preço, isto é um endereço, isto é o nome de quem escreveu. Dados estruturados reduzem a adivinhação, porque você mesmo diz o que é cada coisa.
Dá para ler um bloco, escrever o seu, testar e descobrir sozinho por que um erro apareceu, mesmo sem programar. Se preferir pular a digitação, o gerador de schema da B20 monta o bloco e confere o que você colar.
O que é Schema.org
Schema.org é um vocabulário aberto, fundado por Google, Microsoft, Yahoo e Yandex, com nomes combinados para as coisas que aparecem numa página: Organization para uma empresa, Product para um produto, Article para um texto, e assim por diante. Cada tipo tem propriedades, como name, price e author.
Segundo o próprio Schema.org, em 2024 mais de 45 milhões de domínios marcavam as suas páginas com esse vocabulário.
Dois nomes costumam ser confundidos:
- Schema.org é o vocabulário: as palavras que você pode usar.
- JSON-LD é um formato: o jeito de escrever essas palavras no código. Os outros dois formatos aceitos são Microdata e RDFa.
O Google diz, na sua documentação, que recomenda o JSON-LD sempre que a estrutura do site permitir. É um bloco separado do texto, mais fácil de manter e de conferir.
O que os dados estruturados fazem e o que não fazem
Fazem duas coisas:
- Ajudam o buscador a entender a página sem depender de interpretação.
- Deixam a página apta a alguns resultados enriquecidos do Google, como o preço e a avaliação de um produto ou a trilha de navegação no lugar do endereço.
Não fazem três coisas:
- Não são promessa de resultado enriquecido. A documentação do Google diz que a marcação torna a página apta, e que mesmo uma marcação correta pode não ser exibida.
- Não melhoram uma página ruim. Texto raso com marcação perfeita continua raso.
- Não permitem marcar o que a pessoa não vê. A regra do Google é direta: não adicione dado estruturado sobre informação que não está visível para o usuário, ainda que a informação seja verdadeira.
Como ler um bloco, linha por linha
Todo bloco em JSON-LD tem a mesma anatomia. Este descreve uma padaria fictícia:
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "Padaria Aurora",
"url": "https://www.padariaaurora.example",
"telephone": "+55 84 3000-0000",
"address": {
"@type": "PostalAddress",
"streetAddress": "Rua das Flores, 100",
"addressLocality": "Natal",
"addressRegion": "RN",
"addressCountry": "BR"
}
}
- A primeira linha, com @context, diz qual vocabulário está em uso. É sempre o endereço do Schema.org.
- A linha com @type diz o que a coisa é. Trocar o tipo muda quais propriedades fazem sentido.
- As linhas seguintes são pares de nome e valor. O nome vem do vocabulário e não se traduz; o valor é o seu dado, igual ao que está na tela.
- Um valor pode ser outra coisa inteira. O endereço não é um texto: é um
PostalAddress, com as suas próprias propriedades. Isso se chama aninhar. - A pontuação é rígida. Aspas duplas em tudo, vírgula entre as linhas e nenhuma vírgula depois da última. Vírgula sobrando é um erro de digitação frequente.
O bloco vai dentro de uma tag de script do tipo application/ld+json, em qualquer lugar do código da página.
Os tipos que valem para uma empresa
| Tipo | Em que página | O que o Google exige | O que o Google recomenda |
|---|---|---|---|
| Organization | Página inicial ou "sobre" | Nada | Nome, endereço do site, logo, contatos |
| LocalBusiness | Página inicial ou de contato | Nome e endereço | Telefone, endereço do site, horário |
| Product | Página de produto | Nome e pelo menos um entre oferta, avaliação e nota | Preço com moeda e disponibilidade |
| Article ou BlogPosting | Texto de blog | Nada | Título, autor, datas de publicação e de atualização, imagem |
| BreadcrumbList | Todas | A lista de itens, cada um com posição e nome | Não há |
A coluna do que é exigido vem das páginas de cada tipo na documentação do Google, consultadas em 17/11/2026. Três detalhes que essas páginas trazem e que quase ninguém lê:
- Organization vai em uma página só. O Google recomenda a página inicial ou uma página que descreva a empresa. Não é preciso repetir no site inteiro.
- Autor é só o nome. Em
author.nameentra o nome da pessoa, sem cargo, sem título e sem o nome do site. Cada autor ganha a sua própria entrada, com o endereço de uma página que o identifique. - Imagem de artigo pede três formatos. A recomendação é ter imagens nas proporções 16 por 9, 4 por 3 e 1 por 1, em boa resolução.
Comece pelos tipos que se aplicam ao seu site. Marcar bem três vale mais do que marcar mal dez.
Dois exemplos para adaptar
Uma página de produto, com a oferta aninhada:
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Pão de fermentação natural",
"image": "https://www.padariaaurora.example/pao.jpg",
"description": "Pão de 600 gramas, feito com fermento natural.",
"offers": {
"@type": "Offer",
"priceCurrency": "BRL",
"price": "24.90",
"availability": "https://schema.org/InStock"
}
}
Repare no preço: só número, com ponto no lugar da vírgula e sem o símbolo da moeda. A moeda vai na linha de cima.
Um texto de blog, com autor e datas:
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Como conservar pão de fermentação natural",
"datePublished": "2026-11-01",
"dateModified": "2026-11-10",
"author": {
"@type": "Person",
"name": "Maria Aurora",
"url": "https://www.padariaaurora.example/equipe/maria-aurora"
}
}
As datas seguem a ordem ano, mês e dia, com hífen. Data escrita como no dia a dia, com barras, é erro.
Como implementar no WordPress, passo a passo
- Veja o que o site já tem. Abra a página, peça para ver o código-fonte (no computador, o atalho costuma ser Ctrl e U) e procure por
ld+json. Muitos temas e plugins já escrevem um bloco, e dois blocos diferentes sobre a mesma coisa confundem mais do que ajudam. - Preencha o plugin de SEO primeiro. Os plugins mais usados têm uma tela para o nome da empresa, o logo e os perfis, e geram sozinhos a marcação de empresa, de artigo e de trilha.
- Complete o que falta com um bloco próprio. Para um tipo que o plugin não cobre, monte o bloco, com o gerador ou à mão, e cole num bloco de HTML personalizado da página.
- Em loja, deixe o código ler o cadastro. Preço e estoque mudam todo dia. A marcação de produto deve sair do mesmo cadastro que alimenta a tela, e não de um bloco digitado.
- Publique e teste a página no ar, não só o bloco.
Como testar
São duas ferramentas, e elas respondem a perguntas diferentes.
O validador do Schema.org responde: o bloco está escrito certo? Ele confere a gramática e mostra cada tipo e cada propriedade que entendeu.
O Teste de pesquisa aprimorada, do Google, responde: esta página fica apta a algum resultado enriquecido? Ele só fala dos tipos que o Google usa, e separa erro de aviso.
O caminho é o mesmo nas duas: cole o endereço da página, ou escolha a opção de código e cole o bloco. Teste o bloco antes de publicar e o endereço depois.
Depois de publicado, o Search Console passa a mostrar relatórios dos resultados enriquecidos que encontrou no site, com os erros que aparecerem ao longo do tempo. É ali que se descobre que uma atualização de tema quebrou a marcação.
Como ler os erros mais comuns
| O que a ferramenta diz | O que quer dizer | Como resolver |
|---|---|---|
| Erro de sintaxe ou de análise | O bloco não é um JSON válido | Procure vírgula sobrando, aspas faltando ou chave sem fechar |
| Campo obrigatório ausente | Falta uma propriedade que o tipo exige | Acrescente a propriedade, se o dado estiver na página; se não estiver, o tipo não serve |
| Valor inválido | O dado está no formato errado | Preço com ponto, data com hífen, endereço começando com https |
| Aviso de campo recomendado | Não impede nada, mas completa a marcação | Preencha se o dado existir na página; não invente |
| Nenhum item detectado | O teste não achou tipo que o Google usa | O bloco pode estar certo para o Schema.org e não render resultado enriquecido |
Erro impede. Aviso sugere. Não invente dado para calar um aviso: avaliação que a página não mostra e preço que não existe vão contra a regra de marcar só o que está visível.
O que mudou em 2025 e 2026
O Google tira do ar, de tempos em tempos, resultados enriquecidos que usa pouco. O registro de mudanças da documentação mostra o que saiu:
- Perguntas frequentes (FAQPage). O resultado deixou de aparecer na busca do Google em 7 de maio de 2026, e a documentação foi retirada em 15 de junho de 2026. Quem marcou perguntas só para ganhar espaço no resultado não tem mais esse efeito.
- Vários tipos de uma vez. Em 9 de setembro de 2025 saiu a documentação de informações de curso, estimativa de salário, vídeo de aprendizagem, aviso especial e listagem de veículo.
- Trilha de navegação. Desde janeiro de 2025 o resultado com a trilha aparece só no computador.
- Avaliações. Em julho de 2026 entrou nas regras uma diretriz contra avaliação falsa e contra avaliação incentivada sem aviso.
A lista é mais antiga do que parece. Em 14 de setembro de 2023, o mesmo registro anotou a retirada da documentação do resultado de passo a passo, do tipo HowTo, que deixou de ser exibido no computador e no celular. Tutoriais antigos ainda mandam marcar esse tipo.
Marcação de um tipo que o Google deixou de mostrar não faz mal ao site. Ela só não rende mais o resultado enriquecido. Antes de pagar por uma implementação, confira na documentação do Google se o tipo ainda é exibido.
Os erros de quem implementa
- Marcar o que não está na página. Nota de avaliação sem avaliação visível, preço que não aparece, autor que o texto não mostra.
- Copiar código gerado por IA sem conferir. A IA inventa propriedade que não existe e preenche campo com dado que a página não tem. Todo bloco passa pelo teste antes de ir ao ar.
- Dois blocos brigando. O tema escreve um, o plugin escreve outro, e alguém cola um terceiro. Fique com um por tipo.
- Esquecer depois de publicar. O preço muda na página e fica antigo na marcação.
Dados estruturados ajudam a aparecer nas respostas de IA?
Não há atalho. Na página sobre os recursos de IA da busca, o Google diz que não existe requisito adicional para aparecer nos AI Overviews ou no Modo IA, e que não há dado estruturado especial para isso. O que vale é o de sempre: página indexada, com conteúdo que responde e que pode ser exibido com trecho.
Dados estruturados continuam úteis porque deixam claro quem é a empresa, o que ela vende e por quanto. Isso é trabalho de base, feito uma vez e mantido.
Como a B20 trata o assunto
Todo site institucional feito pela B20 sai com a base de SEO e de GEO, que inclui os dados estruturados. Neste site, cada página repete na marcação só o que está escrito na tela, e há testes automáticos que conferem isso a cada mudança. Para um site que já existe, o começo é a auditoria de SEO, que custa R$ 1.250 e inclui a leitura técnica do site.
Perguntas rápidas
Preciso saber programar?
Para ler, gerar e testar, não. Para implementar fora do que o plugin oferece, é preciso colar o bloco no código da página.
Dados estruturados melhoram a posição no Google?
A documentação do Google apresenta a marcação como um jeito de o buscador entender a página e de habilitar resultados enriquecidos. Ela não é apresentada como fator de posição.
Posso marcar perguntas e respostas mesmo sem o resultado no Google?
Pode, se as perguntas estiverem na página. Só não espere o espaço extra no resultado, que deixou de existir em 2026.
Com que frequência devo revisar?
Sempre que a página mudar de preço, de endereço ou de autor, e quando o Google anunciar mudança nos tipos que você usa.
Quer o preço do seu caso?
Escolha o serviço e os adicionais e veja o total na hora, sem cadastro.
Montar orçamento