El marcado schema dice a las máquinas qué significa tu contenido. Pero el formato que uses importa. Puedes escribir marcado schema en tres lenguajes distintos: Microdata, RDFa y JSON-LD. La mayor parte de la web usa Microdata porque es antiguo y fácil. Los sistemas de IA prefieren JSON-LD porque es limpio, estructurado y sin ambigüedades.
JSON-LD significa JSON for Linking Data. Es un formato inventado específicamente para que las máquinas lean datos estructurados sin ensuciar tu HTML. Lo escribes en una etiqueta script aparte. Tu contenido visible se mantiene limpio. Los datos legibles por máquinas están en su propio bloque. Los rastreadores de IA interpretan JSON-LD más rápido y con más fiabilidad que otros formatos. Si quieres que los sistemas de IA puedan citar tu contenido, JSON-LD es la forma de conseguirlo.
Por qué JSON-LD supera a otros formatos de schema
Microdata se ve así. Añades atributos directamente a tus etiquetas HTML:
<div itemscope itemtype="https://schema.org/Article">
<h1 itemprop="headline">Article Title</h1>
<p itemprop="description">Article summary.</p>
</div>
Funciona. Google lo lee. Pero tu HTML se llena de atributos de schema. El contenido y los metadatos quedan enredados.
JSON-LD los separa por completo:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"description": "Article summary"
}
</script>
Tu HTML se mantiene limpio. Los datos legibles por máquinas están en su propia etiqueta script. Los rastreadores de IA prefieren esta separación. Es más clara. Es menos propensa a errores. Se interpreta más rápido.
RDFa es un tercer formato, pero se usa poco. Es más complejo que Microdata y que JSON-LD. Ni Google ni los sistemas de IA lo prefieren. Descarta RDFa.
Cómo leen JSON-LD los sistemas de IA
Cuando un rastreador de IA visita tu página, hace dos cosas. Lee tu contenido HTML visible. Y analiza las etiquetas script JSON-LD que encuentre.
El JSON-LD le dice: esta página es un Article. Se publicó en esta fecha. La escribió este autor. El tema principal es este. Hay una imagen en esta URL. El recuento de palabras es este. Todos esos metadatos ayudan al sistema de IA a entender el contenido con más profundidad de la que podría lograr solo con el texto.
Cuando después el sistema de IA decide si te cita, usa esos metadatos. Un schema Article en JSON-LD bien formateado, con fecha de publicación, autor e imagen, se cita más que el mismo contenido sin ningún schema. Los metadatos prueban que eres la fuente original.
La estructura esencial de JSON-LD
Todo bloque JSON-LD tiene tres partes básicas. El @context dice al intérprete qué vocabulario usas (casi siempre schema.org). El @type le dice qué tipo de cosa describes. Las propiedades describen los atributos concretos.
Un schema Article básico se ve así:
<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>
Ese bloque JSON-LD va en el head de tu página (o en cualquier parte del body). Le dice al rastreador todo lo que necesita saber sobre el artículo.
Dónde colocar JSON-LD en tu página
La mejor práctica es colocar JSON-LD en la sección head de tu HTML, por encima del contenido visible. El rastreador lee primero el head, así que obtiene los metadatos de schema antes incluso de empezar a analizar el body.
Pero JSON-LD funciona en cualquier parte de la página. En el head. En el body. Antes del contenido. Después del contenido. No importa. Mientras el JSON sea válido, los rastreadores lo encontrarán y lo interpretarán.
Muchas plataformas de contenido colocan JSON-LD automáticamente en el head cuando rellenas los campos de metadatos. Escribes un titular, una descripción y una fecha de publicación en tu CMS. La plataforma genera el JSON-LD automáticamente. No lo escribes a mano.
JSON-LD para distintos tipos de contenido
Article es el tipo de schema más común, pero JSON-LD admite muchos tipos. Cada tipo tiene propiedades obligatorias y opcionales distintas.
Schema FAQPage
Si tu página tiene una sección de preguntas frecuentes, usa el schema FAQPage. Indica a los rastreadores de IA exactamente dónde están tus preguntas y respuestas:
<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>
El schema FAQPage mejora la probabilidad de que los sistemas de IA extraigan bien tus preguntas y respuestas.
Schema Product
Para el comercio electrónico, usa el 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>
El schema Product dice a los agentes de compra con IA el precio exacto, la disponibilidad y las características de tu producto.
Schema HowTo
Para las guías paso a paso, usa el 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>
El schema HowTo ayuda a los sistemas de IA a entender la secuencia y a extraer los pasos en el orden correcto.
Errores comunes con JSON-LD
El error más común es un JSON no válido. JSON tiene reglas de sintaxis estrictas. Cada cadena debe ir entre comillas dobles. Cada propiedad debe ir seguida de dos puntos. Cada elemento de un objeto o una lista debe separarse con una coma. Si falta una sola coma, todo el JSON se rompe.
Prueba tu JSON antes de publicarlo. Usa una herramienta de validación de JSON. Pega tu JSON-LD en el validador y te dirá si hay errores de sintaxis.
El segundo error es usar un @type equivocado. Si tu página es una publicación de blog, usa Article, no BlogPosting. Si es un producto, usa Product, no Item. El tipo importa porque los rastreadores entienden la estructura de forma distinta según el tipo.
El tercer error es omitir propiedades obligatorias. El schema Article requiere un titular. El schema Product requiere un precio. HowTo requiere al menos un paso. Consulta la documentación de schema.org de cada tipo para ver qué es obligatorio y qué es opcional.
Validar y probar tu JSON-LD
Google tiene una herramienta de prueba de resultados enriquecidos (Rich Results Test). Pegas tu URL y te muestra todo el JSON-LD que encontró en esa página. Te dice si el JSON es válido. Te dice si falta alguna propiedad obligatoria. Te muestra cómo se ven los datos interpretados.
Schema.org también tiene una herramienta de validación. Pega tu JSON-LD y valida la sintaxis y el cumplimiento del schema.
La mayoría de las plataformas CMS tienen validación integrada. Si publicas contenido sin propiedades de schema obligatorias, el CMS te avisa antes de publicar.
Preguntas frecuentes
¿Necesito JSON-LD si ya uso Microdata?
No. Usa un formato o el otro, no los dos. Si usas Microdata y funciona, déjalo. Pero si montas el marcado schema desde cero, JSON-LD es la mejor opción. Es más limpio, más fácil de mantener y los sistemas de IA lo prefieren. Con el creador de webs de WEMASY puedes prepararlo directamente en tu web.
¿Puedo tener varios bloques JSON-LD en la misma página?
Sí. Puedes tener un schema Article en un bloque y un schema Organization en otro. También puedes anidar schemas. Por ejemplo, un schema Article puede contener un schema Person para el autor. Varios bloques no son un problema mientras cada uno sea un JSON válido.
¿Afecta JSON-LD a la velocidad de mi web?
No. JSON-LD es solo texto. Tu servidor no tiene que interpretarlo. El rastreador lo interpreta cuando te visita. No hay impacto en el rendimiento de tu web. Es invisible para tus visitantes.
¿Y si actualizo el contenido pero olvido actualizar el JSON-LD?
Los rastreadores de IA leerán los metadatos antiguos del JSON-LD y tu contenido visible actual. Puede que noten la discrepancia. El titular de tu JSON-LD debe coincidir con tu titular visible. La fecha de publicación debe ser exacta. Si divergen de forma significativa, los rastreadores pueden confiar más en el contenido visible que en los metadatos.
¿Debo usar JSON-LD para los enlaces internos o solo para el contenido principal?
Usa JSON-LD para cualquier contenido que quieras que los sistemas de IA entiendan a fondo. Los artículos principales son los que más se benefician. Las páginas de producto también. Las páginas de preguntas frecuentes también. Los enlaces de navegación simples no necesitan JSON-LD. Concentra tu esfuerzo en el contenido que los sistemas de IA podrían citar o recomendar.
¿Pueden ver los sistemas de IA un JSON-LD oculto con CSS display:none?
Sí. Los rastreadores de IA interpretan JSON-LD tanto si es visible para los usuarios como si no. No necesitas ocultarlo ni mostrarlo. La mayoría de las plataformas colocan el JSON-LD en el head, donde de todos modos no se ve. El rastreador lo ve. Eso es lo que importa.