Construtor de JSON-LD

O que é JSON-LD?

JSON-LD (JSON for Linking Data) é o formato que Google, Bing e a maioria dos buscadores preferem para structured data. Você joga um bloco <script type="application/ld+json"> no <head> com um objeto JSON descrevendo a página — e o crawler usa para habilitar rich results: estrelas de review, accordions de FAQ, cards de receita, listagens de evento. O vocabulário vem do Schema.org, uma ontologia mantida pela comunidade com cerca de 800 tipos e 1.400 propriedades.

Como usar este construtor

Escolha o tipo de schema que descreve o conteúdo principal da página. A maioria precisa de exatamente um bloco — uma página de artigo é Article, uma página de produto é Product, uma página de evento é Event. Preencha os campos obrigatórios (marcados na tabela de referência abaixo); os opcionais ficam para quando você tem o dado, mas pular não é problema. O painel de saída atualiza ao vivo e formata o JSON. Quando a estrutura estiver certa, clique em Copiar JSON-LD e cole o snippet — incluindo as tags <script> — no <head> da página. Valide com o Rich Results Test do Google antes de subir.

JSON-LD vs. Microdata vs. RDFa

Marcação Schema.org pode ser expressa em três sintaxes: Microdata (atributos itemscope / itemprop inline em elementos visíveis), RDFa (ideia parecida, atributos diferentes) e JSON-LD (um bloco JSON autocontido no <head>). O Google recomenda JSON-LD oficialmente desde 2015 porque ele desacopla a marcação do HTML visível — o time de conteúdo edita a página sem quebrar o schema, e structured data é adicionado sem reestruturar templates. Fora manutenção de site legado, JSON-LD é o padrão certo.

Quando usar cada tipo

Tipo	Indicado para	Campos-chave obrigatórios
Article	Notícias, posts de blog, ensaios longos.	`headline, author, datePublished, image`
Product	Páginas de produto em e-commerce — bens físicos ou digitais com preço.	`name, image, offers`
FAQPage	Páginas cujo conteúdo principal é uma lista de perguntas e respostas.	`mainEntity[].name, acceptedAnswer.text`
LocalBusiness	Localização física específica de um negócio com endereço e horário.	`name, address, telephone`
Organization	Página inicial de empresa, ONG ou instituição.	`name, url, logo`
Recipe	Receitas culinárias com ingredientes, passos e tempos.	`name, image, recipeIngredient, recipeInstructions`
Event	Shows, conferências, webinars, cursos — qualquer coisa com horário e local.	`name, startDate, location`

Perguntas frequentes

Isso garante rich result no Google?

Não. JSON-LD válido torna a página elegível, mas o Google decide se mostra o rich result com base em sinais de qualidade, intenção da query e diretrizes de cada categoria. Muitas páginas com marcação perfeita não exibem nenhum extra. Trate o JSON-LD como pré-requisito, não garantia.

Onde colo a saída?

Dentro do <head> da página (ou logo antes do </body> — funcionam os dois). Mantenha o invólucro <script type="application/ld+json">; o crawler procura por esse MIME type exato. Um bloco por tipo por página é suficiente.

Posso ter vários blocos JSON-LD na mesma página?

Pode. Padrão comum é um bloco de Organization em todas as páginas, mais um bloco específico de Article, Product ou Event. O Google une no mesmo grafo, contanto que o JSON de cada bloco seja válido por si só.

Como valido a saída?

Cole o snippet no Rich Results Test do Google para o ponto de vista do consumidor, e no validador Schema.org para uma checagem mais estrita e neutra. Os dois aceitam URL ou snippet direto.

Que formato de data devo usar?

ISO 8601, sempre. Datas: 2026-05-04. Datetimes com fuso: 2026-05-04T19:00-03:00. Durações: PT45M para 45 minutos, PT1H30M para 90 minutos. Buscadores rejeitam o que não bate com 8601.

A ferramenta envia meus dados para um servidor?

Não. O formulário, a serialização do JSON e a validação rodam no navegador. Nada é enviado — você pode montar schema para páginas não publicadas, ferramentas internas ou produtos em stealth sem vazar conteúdo.

Construtor de JSON-LD