A maneira mais rápida de adicionar marcação de esquema em 2026 é gerar um bloco JSON-LD, colá-lo dentro de uma tag <script type="application/ld+json"> no <head> da sua página e validá-lo com o Teste de Resultados Enriquecedos do Google antes de publicar. Você não precisa de um plugin WordPress e não precisa mexer em microdados. Este guia fornece o fluxo de trabalho exato de copiar e colar para sites estáticos, Next.js e Google Tag Manager.
A maioria dos tutoriais sobre como adicionar marcação de esquema para em "instale o Yoast" ou entrega uma parede de teoria do schema.org. Nenhum deles ajuda se você gerencia um site codificado à mão, um aplicativo React ou qualquer coisa que não seja WordPress. Abaixo está o caminho sem plugins: o que é JSON-LD, onde colocá-lo, como escrevê-lo para os três tipos de página mais comuns e o ciclo de validar e depois publicar que detecta erros antes do Google.
O Que Schema Markup e JSON-LD Realmente São#
Schema markup são dados estruturados que você adiciona a uma página para que os mecanismos de busca entendam o que o conteúdo significa, não apenas quais palavras contém. Uma página de receita é apenas texto para um rastreador até que o schema informe "isso é uma Receita, tempo de preparo é 15 minutos, avaliação é 4,8".
JSON-LD (JavaScript Object Notation for Linked Data) é o formato que o Google recomenda para essa marcação. É um bloco de JSON dentro de uma tag script. Ele fica no seu HTML, mas não renderiza visualmente, por isso é tão limpo de trabalhar.
Existem três formas de escrever dados estruturados: JSON-LD, microdata e RDFa. Microdata e RDFa envolvem seu HTML visível em atributos extras, o que é frágil e difícil de manter. JSON-LD vive em um bloco autossuficiente, separado da sua marcação.
Use JSON-LD. O Google o prefere explicitamente há anos, é o mais fácil de adicionar e editar, e você pode inseri-lo em qualquer lugar da página sem reescrever seu HTML existente.
Por que o schema ainda importa em 2026#
O schema faz dois trabalhos agora. O trabalho original são os rich results: estrelas de avaliação, acordeões de FAQ, cards de receitas, trilhas de breadcrumbs na SERP. O Google aposentou alguns deles (FAQ e HowTo rich results foram reduzidos), mas a maioria dos tipos de rich results está viva e ativa.
O trabalho mais novo e maior é alimentar a IA. AI Overviews, ChatGPT Search e Perplexity leem dados estruturados para construir respostas e decidir o que citar. Um schema limpo torna seu conteúdo legível por máquina para os sistemas que cada vez mais ficam entre você e o clique. Essa é a verdadeira razão para se preocupar em 2026.
Como Adicionar Marcação Schema: O Fluxo de Trabalho Sem Plugins#
Aqui está o ciclo de alto nível, depois vamos detalhar cada etapa. O processo todo leva menos de dez minutos depois que você já fez uma vez.
- Escolha o tipo de schema que corresponde à página.
- Gere um JSON-LD válido (manualmente ou com um gerador).
- Cole-o no
<head>da página dentro de uma tag script. - Valide com o Teste de Rich Results e o Validador de Marcação Schema.
- Publique e confirme no Search Console.
Isso funciona para qualquer stack: um arquivo HTML estático, um site Jekyll ou Hugo, Next.js, Astro, PHP puro ou um site que você controla apenas através do Google Tag Manager. A marcação é idêntica. Apenas o método de injeção muda por stack, o que abordamos nas etapas abaixo.
Etapa 1: Escolha o tipo de schema certo para sua página#
Combine o tipo com o que a página realmente é. Escolher o tipo errado é o motivo mais comum para a marcação ser ignorada. Tipos comuns e quando usá-los:
| Tipo de página | Tipo schema.org | O que pode gerar |
|---|---|---|
| Post de blog / artigo de notícias | Article, BlogPosting, NewsArticle | Rich result de artigo, elegibilidade para Top Stories |
| Página de produto | Product + Offer | Preço, disponibilidade, estrelas de avaliação |
| Receita | Recipe | Card de receita, tempo de preparo, avaliações |
| Negócio local | LocalBusiness | Detalhes do pacote de mapas, horário, telefone |
| Empresa / marca | Organization | Painel de conhecimento, logotipo, perfis sociais |
| Conteúdo de perguntas e respostas | FAQPage | Alimenta respostas de IA (rich result descontinuado) |
| Tutoriais passo a passo | HowTo | Alimenta respostas de IA (rich result descontinuado) |
| Qualquer página | BreadcrumbList | Trilha de navegação no SERP |
Uma única página pode conter mais de um tipo. Um post de blog geralmente inclui BlogPosting mais BreadcrumbList e, se relevante, FAQPage. Você pode colocar cada um em sua própria tag script ou combiná-los em um array @graph.
Marque apenas conteúdo que está realmente visível na página. Adicionar schema
Recipea uma página sem receita, ou estrelas de avaliação que você inventou, é uma violação de dados estruturados e pode acionar uma ação manual.
Etapa 2: Gere o código JSON-LD#
Você tem duas opções. Escreva manualmente se conhece bem o tipo, ou use um gerador para evitar erros de sintaxe. Para a maioria das pessoas, gerar é mais rápido e muito menos propenso a erros.
Aqui está um bloco mínimo de Article para você entender a estrutura:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Como Adicionar Marcação Schema (JSON-LD) em 2026",
"author": {
"@type": "Person",
"name": "Saqib Zahoor"
},
"datePublished": "2026-06-25",
"image": "https://exemplo.com/capa.png",
"publisher": {
"@type": "Organization",
"name": "Molixa",
"logo": {
"@type": "ImageObject",
"url": "https://exemplo.com/logo.png"
}
}
}
</script>
Cada bloco precisa de três coisas: @context definido como https://schema.org, um @type e as propriedades obrigatórias para aquele tipo. Se errar nisso, os validadores rejeitam.
Para pular o trabalho manual e os bugs de vírgula no final, nosso gerador de schema markup gratuito cria JSON-LD válido para Article, Product, FAQ, LocalBusiness, Organization e mais. Você preenche os campos, ele gera a tag script e a saída já está sintaticamente correta, para você não perder uma hora com um colchete mal colocado.
Etapa 3: Cole o script no cabeçalho da sua página#
O bloco JSON-LD vai dentro de uma tag <script type="application/ld+json">. O Google lê tanto no <head> quanto no <body>, mas <head> é a convenção mais limpa. Como injetar depende do seu stack.
HTML estático, Jekyll, Hugo, PHP puro: cole a tag script diretamente no cabeçalho do seu template ou arquivo de página. Pronto.
Next.js (App Router): renderize o script na sua página ou layout. O padrão confiável usa dangerouslySetInnerHTML para o React não escapar o JSON:
export default function Page() {
const jsonLd = {
"@context": "https://schema.org",
"@type": "Article",
"headline": "Como Adicionar Marcação Schema (JSON-LD) em 2026"
};
return (
<>
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
/>
{/* conteúdo da página */}
</>
);
}
WordPress sem plugin: se você realmente não quer plugin, cole o script no header.php do tema ou use o campo "HTML personalizado" / código do cabeçalho do tema. (Um plugin é uma conveniência opcional, não um requisito.)
Google Tag Manager (sem acesso ao código): o GTM é a saída de emergência quando você não pode editar a fonte. Crie uma nova tag, escolha "HTML personalizado", cole seu bloco <script type="application/ld+json"> completo e defina o gatilho para as páginas específicas onde a marcação se aplica. Duas precauções com a rota do GTM seguem abaixo.
O GTM injeta schema no lado do cliente, após o carregamento da página via JavaScript. O Google pode renderizar e ler, mas alguns outros crawlers e bots de IA podem não executar sua tag. Se o schema for crítico, prefira marcação renderizada no servidor e trate o GTM como fallback para páginas que você não pode editar de outra forma.
A segunda precaução do GTM: defina o gatilho de forma restrita. Uma tag que dispara em "Todas as Páginas" vai colocar o mesmo schema Article na sua página inicial, página de contato e página 404. Use gatilhos por caminho de página para que cada template receba apenas o schema que corresponde a ele.
Etapa 4: Valide antes de publicar#
Nunca publique schema que você não testou. Duas ferramentas, dois trabalhos:
- Teste de Rich Results (search.google.com/test/rich-results): informa se o Google consegue ler sua marcação e se a página é elegível para um rich result específico. Use isso para qualquer coisa que queira um recurso no SERP.
- Validador de Marcação Schema (validator.schema.org): uma verificação pura de sintaxe e estrutura contra o padrão schema.org. Use para pegar JSON malformado e valores de propriedade inválidos, independentemente da elegibilidade para rich results.
Execute ambos. O Teste de Rich Results sinaliza campos obrigatórios ausentes (um Product sem name, um Article sem headline). O Validador pega problemas estruturais que o verificador de rich results ignora, como uma propriedade anexada ao tipo errado.
Cole sua URL ao vivo (uma vez em staging) ou o código bruto. Corrija todos os erros. Avisos são opcionais, mas geralmente vale a pena resolver, porque um campo "recomendado" hoje pode se tornar um requisito amanhã. Se quiser visualizar como a página marcada pode aparecer na pesquisa junto com o schema, nossa ferramenta de pré-visualização de snippet SERP mostra o título e a descrição lado a lado com suas larguras em pixels.
Etapa 5: Publique e confirme no Search Console#
A validação prova que a sintaxe está correta. Não prova que o Google a rastreou. Após publicar:
- Solicite a indexação da URL no Google Search Console (Inspeção de URL > Solicitar Indexação).
- Aguarde um novo rastreamento. Isso pode levar de horas a semanas, dependendo do seu orçamento de rastreamento.
- Verifique o relatório de Melhorias relevante no Search Console (por exemplo, "Produtos" ou "Breadcrumbs"). Ele mostra itens válidos, avisos e erros detectados em suas páginas ao vivo em escala.
O Search Console é a única fonte da verdade sobre o que o Google realmente analisou em produção. Uma página pode passar no Teste de Rich Results isoladamente e ainda gerar erros ao vivo se, por exemplo, seu CMS remover a tag script ou um CDN armazenar em cache uma versão antiga. Monitore o relatório de Melhorias por uma semana após a implantação.
Erros Comuns de Marcação Schema a Evitar#
Estes são os erros que silenciosamente matam os rich results mesmo quando seu JSON-LD parece correto.
- Marcar conteúdo que não está na página. Estrelas de avaliação sem avaliações visíveis, ou schema de FAQ sem FAQ visível, é uma violação das diretrizes. Os dados estruturados devem refletir o que o visitante vê.
- Vírgulas sobressalentes e aspas não escapadas. JSON é rigoroso. Uma vírgula sobressalente quebra todo o bloco. Essa é exatamente a classe de bug que um gerador elimina.
- Tipo errado para a página.
Articleem uma página de produto, ouLocalBusinessem um post de blog, confunde o parser e não gera nada. - Blocos duplicados ou conflitantes. Dois scripts
Articlecom títulos diferentes na mesma página enviam sinais mistos. Mantenha um bloco autoritativo por tipo, ou unifique-os em um@graph. - Esquecer o
publishere aimageem artigos. Esses são comumente exigidos para elegibilidade e rotineiramente omitidos. - IDs de autorreferência que não correspondem. Se você usar
@idpara vincular entidades (Article para Organization para Person), os IDs precisam realmente corresponder entre os blocos.
Se um rich result não aparecer após uma validação bem-sucedida e um recrawl, a causa é quase sempre elegibilidade, não sintaxe. Refaça o teste no Rich Results Test para aquele tipo de resultado específico. Elegível não garante exibição; o Google decide por consulta.
Quando Você Precisa de Mais de Um Tipo de Schema#
Páginas reais raramente são de um único tipo. Um artigo de avaliação de produto pode justificar Article para o post, Product mais Review para o item e BreadcrumbList para navegação. Você tem duas maneiras limpas de combiná-los.
A abordagem mais simples são várias tags de script, uma por tipo. O Google lê todas. É fácil de manter porque cada bloco é independente, e você pode adicionar ou remover um sem tocar nos outros.
A abordagem mais elegante é um único array @graph que contém todas as entidades em uma tag de script, vinculando-as com referências @id. Isso evita repetir dados compartilhados (como os detalhes da sua Organização) e é como a maioria dos CMS emite schema internamente. Use @graph quando as entidades se referenciam; use tags separadas quando são independentes.
Para decidir quais tipos de schema ainda valem a pena com as recentes mudanças nos rich results do Google, nossa análise sobre se o schema FAQ ainda vale a pena em 2026 explica o que foi descontinuado e o que agora importa para a busca com IA, e o guia completo para gerar schema para rich results aborda a seleção de tipos em mais profundidade.
Como Adicionar Marcação de Schema de Forma Rápida: Um Resumo#
Saber como adicionar marcação de schema se resume a um ciclo repetível, não a memorizar schema.org. Escolha o tipo que corresponde à página, gere JSON-LD válido, cole-o em uma tag <script type="application/ld+json"> no cabeçalho, valide com o Teste de Resultados Enriquecedos e o Validador de Marcação de Schema, depois implante e confirme no Search Console.
Nenhum plugin é necessário para isso. Sites estáticos, Next.js e GTM usam o mesmo JSON-LD; apenas o ponto de injeção muda. Gere sua marcação com o gerador de schema, execute-o em ambos os validadores e veja o relatório de Melhorias após a implantação. Esse é o fluxo de trabalho completo, e ele escala de uma página para um site inteiro.
Perguntas Frequentes#
Preciso de um plugin para adicionar marcação de schema? Não. JSON-LD é apenas um bloco de script que você cola no cabeçalho da página, então qualquer site pode usá-lo sem plugin. Plugins como Yoast ou Rank Math são uma conveniência para usuários WordPress, mas sites estáticos, aplicativos Next.js e até sites que você controla apenas pelo Google Tag Manager adicionam o mesmo JSON-LD manualmente.
Onde exatamente o script JSON-LD deve ir?
Dentro de uma tag <script type="application/ld+json">, idealmente no <head> da página. O Google lê tanto do <head> quanto do <body>, mas o cabeçalho é a convenção mais limpa. No Next.js, renderize o script com dangerouslySetInnerHTML para que o React não escape o JSON.
Como validar a marcação de schema? Use duas ferramentas. O Teste de Resultados Rich (search.google.com/test/rich-results) verifica se o Google consegue lê-lo e se a página é elegível para um resultado rich. O Validador de Marcação de Schema (validator.schema.org) verifica a sintaxe bruta e a estrutura em relação à especificação schema.org. Execute ambos, corrija todos os erros e depois publique.
Posso adicionar marcação de schema pelo Google Tag Manager? Sim. Crie uma tag HTML personalizada, cole seu bloco de script JSON-LD completo e defina um gatilho de caminho de página para que ele seja acionado apenas onde a marcação se aplica. A desvantagem é que o GTM injeta o schema no lado do cliente, então alguns rastreadores não-Google podem não executá-lo. Prefira schema renderizado no servidor quando for crítico e use o GTM como fallback para páginas que você não pode editar.
A marcação de schema ainda ajuda no SEO em 2026? Sim, de duas maneiras. Ela ainda alimenta muitos resultados rich (produto, receita, breadcrumbs e outros) e cada vez mais alimenta AI Overviews, ChatGPT Search e Perplexity, que leem dados estruturados para construir e citar respostas. O schema não aumenta diretamente os rankings, mas torna seu conteúdo legível por máquina para os sistemas que decidem o que é exibido.
Por que meu resultado rich não aparece depois que adicionei schema válido? A validação apenas prova que sua sintaxe está correta. Um resultado pode ainda não aparecer porque a página não é elegível para aquele tipo de resultado, porque o Google ainda não a recrawleou, ou porque a marcação descreve conteúdo não visível na página. Verifique o tipo de resultado específico no Teste de Resultados Rich, solicite indexação no Search Console e confirme se os dados correspondem ao que os visitantes veem.
