EN
PT
ES
Constructor de JSON-LD
Arma bloques <code>application/ld+json</code> válidos para Article, Product, FAQPage, Recipe, Event, Organization y LocalBusiness — copia y pega en tu <code><head></code>.
¿Qué es JSON-LD?
JSON-LD (JSON for Linking Data) es el formato que Google, Bing y la mayoría de los buscadores prefieren para structured data. Tiras un bloque <script type="application/ld+json"> en el <head> de la página con un objeto JSON describiéndola — y el crawler lo usa para habilitar rich results: estrellas de reseña, accordions de FAQ, tarjetas de receta, listados de eventos. El vocabulario viene de Schema.org, una ontología mantenida por la comunidad con unos 800 tipos y 1.400 propiedades.
Cómo usar este constructor
Elige el tipo de schema que coincide con el contenido principal de la página. La mayoría necesita exactamente un bloque — una página de artículo es Article, una de producto es Product, una de evento es Event. Llena los campos obligatorios (marcados en la tabla de referencia abajo); los opcionales están si tienes el dato, pero saltarlos está bien. El panel de salida se actualiza en vivo y reformatea el JSON. Cuando la estructura se vea bien, haz clic en Copiar JSON-LD y pega el snippet — incluyendo los tags <script> — en el <head> de la página. Valida con el Rich Results Test de Google antes de publicar.
JSON-LD vs. Microdata vs. RDFa
El marcado Schema.org se puede expresar en tres sintaxis: Microdata (atributos itemscope / itemprop inline en elementos visibles), RDFa (idea similar, atributos distintos) y JSON-LD (un bloque JSON autocontenido en <head>). Google recomienda oficialmente JSON-LD desde 2015 porque desacopla el marcado del HTML visible — el equipo de contenido edita la página sin romper el schema, y se agrega structured data sin reestructurar plantillas. Salvo que mantengas un sitio legacy, JSON-LD es el default correcto.
Cuándo usar cada tipo
| Tipo | Indicado para | Campos clave obligatorios |
|---|---|---|
| Article | Notas, posts de blog, ensayos largos. | headline, author, datePublished, image |
| Product | Páginas de producto en e-commerce — bienes físicos o digitales con precio. | name, image, offers |
| FAQPage | Páginas cuyo contenido principal es una lista de preguntas y respuestas. | mainEntity[].name, acceptedAnswer.text |
| LocalBusiness | Una ubicación física específica de un negocio con dirección y horario. | name, address, telephone |
| Organization | Página principal de una empresa, ONG o institución. | name, url, logo |
| Recipe | Recetas de cocina con ingredientes, pasos y tiempos. | name, image, recipeIngredient, recipeInstructions |
| Event | Conciertos, conferencias, webinars, clases — cualquier cosa con horario y lugar. | name, startDate, location |
Preguntas frecuentes
¿Esto garantiza un rich result en Google?
¿Dónde pego la salida?
<head> de la página (o justo antes del </body> — ambos funcionan). Conserva el envoltorio <script type="application/ld+json">; el crawler busca exactamente ese MIME type. Un bloque por tipo por página alcanza.¿Puedo tener varios bloques JSON-LD en una página?
¿Cómo valido la salida?
¿Qué formato de fecha debo usar?
2026-05-04. Datetimes con zona horaria: 2026-05-04T19:00-03:00. Duraciones: PT45M para 45 minutos, PT1H30M para 90 minutos. Los buscadores rechazan cualquier cosa que no parsee como 8601.