A marcação schema diz às máquinas o que o teu conteúdo significa. Mas o formato que usas importa. Podes escrever marcação schema em três linguagens diferentes: Microdata, RDFa e JSON-LD. A maior parte da web usa Microdata porque é antiga e fácil. Os sistemas de IA preferem JSON-LD porque é limpo, estruturado e inequívoco.
JSON-LD significa JSON for Linking Data. É um formato inventado especificamente para tornar os dados estruturados legíveis por máquinas sem sobrecarregar o teu HTML. Escreves-o numa etiqueta script separada. O teu conteúdo visível mantém-se limpo. Os dados legíveis por máquinas ficam no seu próprio bloco. Os rastreadores de IA processam JSON-LD de forma mais rápida e fiável do que outros formatos. Se queres que o teu conteúdo seja citável pelos sistemas de IA, o JSON-LD é a forma de o conseguires.
Porque o JSON-LD vence os outros formatos de schema
O Microdata é assim. Acrescentas atributos diretamente às tuas etiquetas HTML:
<div itemscope itemtype="https://schema.org/Article">
<h1 itemprop="headline">Article Title</h1>
<p itemprop="description">Article summary.</p>
</div>
Funciona. O Google lê-o. Mas o teu HTML fica sobrecarregado com atributos de schema. O conteúdo e os metadados ficam emaranhados.
O JSON-LD separa-os por completo:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"description": "Article summary"
}
</script>
O teu HTML fica limpo. Os dados legíveis por máquinas estão na sua própria etiqueta script. Os rastreadores de IA preferem esta separação. É mais clara. Tem menos probabilidade de erros. É processada mais depressa.
O RDFa é um terceiro formato, mas raramente usado. É mais complexo do que o Microdata e o JSON-LD. Nem o Google nem os sistemas de IA o preferem. Ignora o RDFa.
Como os sistemas de IA leem o JSON-LD
Quando um rastreador de IA visita a tua página, faz duas coisas. Lê o teu conteúdo HTML visível. E processa as etiquetas script de JSON-LD que encontrar.
O JSON-LD diz-lhe: esta página é um Article. Foi publicada nesta data. Foi escrita por este autor. O tema principal é este. Há uma imagem neste URL. A contagem de palavras é esta. Todos esses metadados ajudam o sistema de IA a perceber o conteúdo mais a fundo do que conseguiria só pelo texto.
Quando o sistema de IA decide depois se te cita, usa esses metadados. Um schema Article em JSON-LD bem formatado, com data de publicação, autor e imagem, é citado com mais frequência do que o mesmo conteúdo sem qualquer schema. Os metadados provam que és a fonte original.
A estrutura essencial do JSON-LD
Cada bloco de JSON-LD tem três partes essenciais. O @context diz ao analisador que vocabulário estás a usar (quase sempre schema.org). O @type diz-lhe que tipo de coisa estás a descrever. As propriedades descrevem os atributos específicos.
Um schema Article básico é assim:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"description": "Your article summary",
"image": "https://yoursite.com/image.jpg",
"datePublished": "2026-04-17",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Your Brand",
"logo": {
"@type": "ImageObject",
"url": "https://yoursite.com/logo.jpg"
}
}
}
</script>
Esse bloco de JSON-LD fica no head da tua página (ou em qualquer sítio do body). Diz ao rastreador tudo o que precisa de saber sobre o artigo.
Onde colocar o JSON-LD na tua página
A melhor prática é colocar o JSON-LD na secção head do teu HTML, acima do conteúdo visível. O rastreador lê primeiro o head, por isso obtém os metadados do schema antes mesmo de começar a processar o body.
Mas o JSON-LD funciona em qualquer parte da página. No head. No body. Antes do conteúdo. Depois do conteúdo. Não importa. Desde que o JSON seja válido, os rastreadores vão encontrá-lo e processá-lo.
Muitas plataformas de conteúdo colocam automaticamente o JSON-LD no head quando preenches os campos de metadados. Escreves um título, uma descrição e uma data de publicação no teu CMS. A plataforma gera o JSON-LD automaticamente. Não o escreves à mão.
JSON-LD para diferentes tipos de conteúdo
Article é o tipo de schema mais comum, mas o JSON-LD suporta muitos tipos. Cada tipo tem propriedades obrigatórias e opcionais diferentes.
Schema FAQPage
Se a tua página tem uma secção de perguntas frequentes, usa o schema FAQPage. Diz aos rastreadores de IA exatamente onde estão as tuas perguntas e respostas:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "JSON-LD is a structured data format that AI systems prefer."
}
},
{
"@type": "Question",
"name": "Where do I put JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "In the head or body of your HTML page."
}
}
]
}
</script>
O schema FAQPage aumenta a probabilidade de os sistemas de IA extraírem corretamente as tuas perguntas e respostas.
Schema Product
Para lojas online, usa o schema Product:
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Product Name",
"description": "Product description",
"image": "https://yoursite.com/product.jpg",
"brand": {
"@type": "Brand",
"name": "Your Brand"
},
"offers": {
"@type": "Offer",
"url": "https://yoursite.com/product",
"priceCurrency": "USD",
"price": "99.99"
}
}
</script>
O schema Product diz aos agentes de compras com IA o preço exato, a disponibilidade e as características do teu produto.
Schema HowTo
Para guias passo a passo, usa o schema HowTo:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Set Up JSON-LD",
"step": [
{
"@type": "HowToStep",
"name": "Step 1",
"text": "Add a script tag to your page head."
},
{
"@type": "HowToStep",
"name": "Step 2",
"text": "Write valid JSON inside the script tag."
}
]
}
</script>
O schema HowTo ajuda os sistemas de IA a perceber a sequência e a extrair os passos pela ordem certa.
Erros comuns com o JSON-LD
O erro mais comum é JSON inválido. O JSON tem regras de sintaxe rigorosas. Cada texto tem de estar entre aspas duplas. Cada propriedade tem de ser seguida de dois pontos. Cada objeto ou item de uma lista tem de ser separado por uma vírgula. Falha uma vírgula e o JSON inteiro quebra.
Testa o teu JSON antes de o colocares online. Usa uma ferramenta de validação de JSON. Cola o teu JSON-LD no validador e ele diz-te se há erros de sintaxe.
O segundo erro é usar o @type errado. Se a tua página é uma publicação de blogue, usa Article, não BlogPosting. Se é um produto, usa Product, não Item. O tipo importa porque os rastreadores percebem a estrutura de forma diferente consoante o tipo.
O terceiro erro é faltarem propriedades obrigatórias. O schema Article exige um headline. O schema Product exige um preço. O HowTo exige pelo menos um passo. Consulta a documentação do schema.org para cada tipo para ver o que é obrigatório e o que é opcional.
Validar e testar o teu JSON-LD
O Google tem uma ferramenta Rich Results Test. Colas o teu URL e ela mostra todo o JSON-LD que encontrou nessa página. Diz-te se o JSON é válido. Diz-te se faltam propriedades obrigatórias. Diz-te como são os dados processados.
O Schema.org também tem uma ferramenta de validação. Cola o teu JSON-LD e ela valida a sintaxe e a conformidade com o schema.
A maioria das plataformas de CMS tem validação integrada. Se publicares conteúdo com propriedades de schema obrigatórias em falta, o CMS avisa-te antes de publicar.
Perguntas frequentes
Preciso de JSON-LD se já uso Microdata?
Não. Usa um formato ou o outro, não ambos. Se usas Microdata e está a funcionar, mantém-no. Mas se estás a configurar a marcação schema de raiz, o JSON-LD é a melhor escolha. É mais limpo, mais fácil de manter e os sistemas de IA preferem-no. Com o criador de websites da WEMASY, podes montar isto diretamente no teu website.
Posso ter vários blocos de JSON-LD na mesma página?
Sim. Podes ter um schema Article num bloco e um schema Organization noutro. Também podes aninhar schemas. Por exemplo, um schema Article pode conter um schema Person para o autor. Vários blocos não são problema desde que cada um seja JSON válido.
O JSON-LD afeta a velocidade do meu site?
Não. O JSON-LD é apenas texto. Não exige qualquer processamento pelo teu servidor. O rastreador processa-o quando visita. Não há impacto no desempenho do teu website. É invisível para os teus visitantes.
E se atualizar o conteúdo mas me esquecer de atualizar o JSON-LD?
Os rastreadores de IA vão ler os metadados antigos do JSON-LD e o teu conteúdo visível atual. Podem reparar na incoerência. O título no teu JSON-LD deve corresponder ao teu título visível. A data de publicação deve ser exata. Se divergirem de forma significativa, os rastreadores podem confiar mais no conteúdo visível do que nos metadados.
Devo usar JSON-LD para links internos ou só para o conteúdo principal?
Usa JSON-LD para qualquer conteúdo que queiras que os sistemas de IA percebam a fundo. Os artigos principais são os que mais beneficiam. As páginas de produto beneficiam. As páginas de perguntas frequentes beneficiam. Os simples links de navegação não precisam de JSON-LD. Concentra o esforço no conteúdo que possa ser citado ou recomendado pelos sistemas de IA.
Os sistemas de IA veem JSON-LD escondido com CSS display:none?
Sim. Os rastreadores de IA processam o JSON-LD independentemente de ser visível para os utilizadores. Não precisas de o esconder nem de o mostrar. A maioria das plataformas coloca o JSON-LD no head, onde não é visível de qualquer forma. O rastreador vê-o. É isso que importa.