Artigo
O que é JSON-LD e como implementar Schema.org com ele?
O formato recomendado pelo Google para dados estruturados — e como adicionar ao seu site sem alterar o HTML
JSON-LD (JavaScript Object Notation for Linked Data) é o formato recomendado pelo Google para implementar dados estruturados Schema.org em páginas web. Em vez de adicionar atributos diretamente nas tags HTML (como o formato Microdata exige), o JSON-LD usa um bloco separado no da página — o que torna a implementação mais simples, menos propensa a erros e independente do design da página. Para sistemas de IA generativa, o JSON-LD é a forma mais confiável de declarar o tipo de conteúdo e os atributos da página.
Por que JSON-LD é preferível a outros formatos
Existem três formas de implementar Schema.org: JSON-LD, Microdata e RDFa. O Google recomenda JSON-LD por três razões práticas:
Separação entre dado e apresentação: o JSON-LD fica em um bloco de script separado do HTML principal. Isso significa que mudar o layout da página não afeta os dados estruturados, e mudar os dados estruturados não afeta o layout. Microdata mistura os dois, o que torna a manutenção mais trabalhosa.
Facilidade de manutenção: para atualizar um dado (preço de um produto, horário de uma clínica, telefone de uma loja), basta editar o JSON-LD. Não é necessário navegar pelo HTML para encontrar os atributos corretos.
Compatibilidade com qualquer CMS: WordPress, Shopify, Webflow, Next.js, sites estáticos — JSON-LD funciona em qualquer ambiente porque é apenas um bloco de texto inserido no .
Estrutura básica de um JSON-LD
Todo bloco JSON-LD começa com @context (que aponta para o vocabulário Schema.org) e @type (que define o tipo de entidade):
``html ``
Exemplos práticos por segmento
Loja de roupas (Product): ``json { "@context": "https://schema.org", "@type": "Product", "name": "Jaqueta Corta-Vento Feminina", "description": "Jaqueta leve e impermeável para uso urbano e trilhas curtas", "brand": { "@type": "Brand", "name": "NomeDaMarca" }, "offers": { "@type": "Offer", "price": "299.90", "priceCurrency": "BRL", "availability": "https://schema.org/InStock" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.7", "reviewCount": "83" } } ``
Clínica odontológica (LocalBusiness): ``json { "@context": "https://schema.org", "@type": "Dentist", "name": "Clínica Sorriso Pleno", "address": { "@type": "PostalAddress", "streetAddress": "Rua das Flores, 450", "addressLocality": "São Paulo", "addressRegion": "SP", "postalCode": "01310-000" }, "telephone": "+55-11-3456-7890", "openingHours": ["Mo-Fr 08:00-18:00", "Sa 08:00-13:00"], "priceRange": "$$" } ``
Escritório de advocacia (FAQPage em página de serviços): ``json { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Quanto tempo leva um processo de demissão sem justa causa?", "acceptedAnswer": { "@type": "Answer", "text": "O prazo médio de um processo trabalhista de demissão sem justa causa na Justiça do Trabalho varia entre 6 meses e 2 anos, dependendo da vara, da complexidade do caso e se há ou não acordo." } } ] } ``
Plataforma de cursos (Course): ``json { "@context": "https://schema.org", "@type": "Course", "name": "Excel do Zero ao Avançado", "description": "Curso completo de Excel para profissionais de finanças, RH e administração", "provider": { "@type": "Organization", "name": "EduPro Cursos" }, "hasCourseInstance": { "@type": "CourseInstance", "courseMode": "online", "duration": "PT20H" } } ``
Onde inserir o JSON-LD na página
O bloco deve ser inserido dentro do da página — ou no , que também é aceito pelo Google. Em CMS como WordPress, plugins como Yoast SEO, Rank Math ou Schema Pro automatizam a geração do JSON-LD para tipos comuns. Em plataformas customizadas ou headless, o JSON-LD pode ser gerado programaticamente a partir dos dados da página.
Como validar
O Google disponibiliza a ferramenta Rich Results Test que verifica se o JSON-LD está correto e quais rich results ele pode gerar. O Schema Markup Validator (validator.schema.org) verifica a conformidade com o vocabulário Schema.org independentemente do Google.
A FRT Digital implementa e audita JSON-LD como parte do serviço de AIO, priorizando os tipos com maior impacto em citabilidade para cada segmento. Para identificar quais dados estruturados estão faltando ou incorretos no seu site, comece pela auditoria de AIO Score.