Pular para o conteúdo
Made For Builders iconoMade For Builders

DefinedTerm · Glossário

O que é JSON-LD

JSON-LD (JavaScript Object Notation for Linked Data) é o formato recomendado pelo Google para implementar dados estruturados. É inserido em um bloco de script separado do HTML visível, o que facilita sua manutenção sem risco de quebrar a apresentação. A especificação 1.1 foi publicada pelo W3C e é a sintaxe mais utilizada atualmente para descrever entidades, artigos, produtos e negócios locais de forma legível por motores de busca e modelos de IA.

edu-lopez-paradaPublicado Actualizado

Definição ampliada

JSON-LD são as siglas de JavaScript Object Notation for Linked Data. É um formato leve para representar dados vinculados que estende a sintaxe JSON padrão com um contexto semântico (@context) que define o vocabulário utilizado, normalmente Schema.org. O W3C publicou a versão 1.1 da especificação como Recommendation, e o W3C JSON-LD Working Group continua seu desenvolvimento.

A particularidade técnica que o distingue do Microdata e do RDFa é que ele é inserido na página dentro de uma tag <script type="application/ld+json">, completamente separada do HTML de conteúdo visível. Isso significa que adicionar ou modificar a marcação estruturada não afeta o DOM da página nem exige tocar nos templates de apresentação.

O Google, o Bing e os principais motores de resposta de IA leem o bloco JSON-LD durante o rastreamento e o utilizam para popular o Knowledge Graph, gerar resultados enriquecidos (rich results) e decidir quais fragmentos citar em AI Overviews ou em respostas de motores de resposta como o Perplexity.

Por que importa em 2026

O Google declara explicitamente em sua documentação do Search Central que JSON-LD é o formato recomendado para implementar dados estruturados quando a configuração do site o permite, por ser o mais fácil de implementar e manter em escala. Em 2026, os dados estruturados adquiriram um segundo papel crítico: influenciam diretamente se o conteúdo é citado nos AI Overviews do Google, nos resultados de navegação do ChatGPT e na superfície de motores de resposta.

Para negócios locais do setor de construção e serviços domésticos, os tipos LocalBusiness, Service e FAQPage em JSON-LD determinam com frequência quais informações aparecem no painel do Knowledge Graph e nas respostas de voz de assistentes.

Como funciona

Um bloco JSON-LD mínimo para um negócio local tem esta estrutura:

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "@id": "https://exemplo.com.br/#business",
  "name": "Hidráulica Exemplo",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Rua Principal, 12",
    "addressLocality": "São Paulo",
    "postalCode": "01310-000",
    "addressCountry": "BR"
  },
  "telephone": "+55 11 3000-0000",
  "url": "https://exemplo.com.br"
}

Passos de implementação:

  1. Identificar os tipos Schema.org relevantes para a página (Article, LocalBusiness, FAQPage etc.).
  2. Construir o objeto JSON-LD com os campos obrigatórios e recomendados pelo Google Search Central.
  3. Inserir o bloco no <head> ou ao final do <body> dentro de <script type="application/ld+json">.
  4. Validar com a ferramenta de Teste de Resultados Enriquecidos do Google.
  5. Monitorar no Search Console a aba de Melhorias para detectar erros ou avisos.

Diferença com Microdata e RDFa

FormatoOnde é escritoAcoplado ao HTMLManutençãoRecomendado pelo Google
JSON-LDBloco script separadoNãoFácilSim (preferido)
MicrodataAtributos dentro do HTMLSimMédioAceito
RDFaAtributos dentro do HTMLSimComplexoAceito

O Google aceita os três formatos com igual validade técnica para gerar rich results, mas recomenda JSON-LD porque é menos propenso a erros humanos por não estar entrelaçado com a estrutura de apresentação.

Termos relacionados

Dados estruturados, Organization schema, E-E-A-T.

Fuentes

Términos relacionados

  • structured-data
  • organization-schema
  • e-e-a-t