Un JSON-LD correcto es JSON válido dentro de un elemento <script type="application/ld+json">. Comienza con @context y @type, y describe solo hechos que aparecen en la página. Elija el ejemplo de abajo que corresponda a su página, reemplace cada valor ficticio por el suyo, agregue un solo bloque y pruebe la URL publicada.
Antes de pegar cualquier código, revise lo que su tema, su plugin de SEO o su plataforma ya agregan a esa página. Si ya describe el mismo negocio, producto o artículo, edite esa salida en lugar de agregar una segunda descripción de lo mismo.
Bing Webmaster Tools indica que Bing admite JSON-LD, así que un bloque correcto sirve a más de un motor de búsqueda. Para la búsqueda con IA, consulte si los sistemas de IA usan el marcado schema.
Revise lo que la página ya muestra
Abra la página publicada, vea el código fuente y busque ld+json. Los temas, los plugins de SEO y los creadores de sitios suelen imprimir bloques propios. La configuración de schema de Yoast SEO describe un grafo de schema conectado, y las plantillas de schema de Rank Math admiten schema personalizado. Squarespace genera datos estructurados para entradas de blog, eventos, negocios locales, organizaciones, productos y sitios web, y el centro de ayuda de Shopify indica que los temas pueden incluir datos estructurados, como la información de productos.
Si un bloque ya cubre la entidad, cambie sus valores en la configuración del plugin, del tema o de la plataforma. Dos bloques que describen la misma entidad de forma distinta dan a un rastreador dos conjuntos de datos entre los que elegir. Cuando nada cubre su página, elija el tipo más específico que corresponda, como Restaurant en lugar del LocalBusiness general, tal como recomienda la documentación de Google sobre negocios locales.
Reemplace cada valor ficticio
Todos los ejemplos siguientes usan example.com y nombres inventados. Nada de lo que contienen es verdadero para su sitio, así que cada valor necesita un reemplazo tomado de la propia página. Cambie estos valores en cualquier ejemplo:
- Cada URL de
example.com, incluidas las de imagen, logotipo, video y registro. - Nombres como Example Bakery, Example Publishing y Example Goods.
- Direcciones, teléfonos, horarios, precios, fechas, calificaciones y número de reseñas.
- Autores, editoriales, vendedores, proveedores y organizadores.
- URL de perfiles en redes sociales, SKU y otros identificadores de producto.
Las directrices generales de Google para datos estructurados indican que el marcado debe representar contenido que los visitantes pueden ver. Una calificación, un precio, un evento o un autor que aparece solo en el código no pertenece ahí. Si también necesita los pasos para instalar un bloque en su sitio, cómo agregar datos estructurados a cualquier sitio web explica las vías de instalación en orden.
La revisión funciona bien entre dos personas. Una lee la página en voz alta mientras la otra lee el bloque, y cada valor se confirma con la página o se cambia.

Obligatorio para una función de Google, recomendado y opcional
La palabra «obligatorio» tiene significados distintos según quién la pida. Un JSON válido es un nivel. Un vocabulario válido de schema.org es un segundo nivel. Los requisitos de una función de Google son un tercero, y si algo se indexa y se muestra es un cuarto. Ninguno de estos implica el siguiente.
Una propiedad puede ser obligatoria para el fragmento de producto de Google y opcional en el vocabulario más amplio de schema.org. Tipos como Offer, Person, Service y FAQPage son vocabulario válido de schema.org, aunque no haya un resultado enriquecido de Google asociado a ellos. Google indica que el marcado correcto no garantiza un resultado enriquecido (directrices generales de Google para datos estructurados).
Las propiedades recomendadas son útiles cuando representan información real, y las opcionales aportan claridad sin ser necesarias. Para ayudarle a elegir entre todos los tipos, tipos de marcado schema que importan para la búsqueda los agrupa según su propósito.
Ejemplos de Organization y LocalBusiness
Use Organization para una empresa, una publicación o una marca sin tienda física. Google no enumera propiedades obligatorias para el marcado de Organization. Google recomienda además name, url, logo, sameAs, telephone y address (documentación de Google sobre Organization). Reemplace el @id por la URL de su página de inicio seguida de #organization, y conserve ese identificador sin cambios cada vez que se refiera a la empresa más adelante.
{
"@context": "https://schema.org",
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Example Bakery",
"url": "https://example.com/",
"logo": "https://example.com/images/logo.png",
"sameAs": [
"https://social.example.org/examplebakery",
"https://photos.example.net/examplebakery"
],
"telephone": "+1-555-010-1000",
"address": {
"@type": "PostalAddress",
"streetAddress": "100 Example Avenue",
"addressLocality": "Austin",
"addressRegion": "TX",
"postalCode": "78701",
"addressCountry": "US"
}
}El generador de schema de Organization crea este bloque con sus propios datos. Un negocio con ubicación física puede usar el tipo LocalBusiness. Obligatorio para esta función de Google: name y address. Recomendado: url, telephone, image, geo, openingHoursSpecification y priceRange (documentación de Google sobre negocios locales).
Cambie LocalBusiness por un subtipo que describa el lugar, como Restaurant, Store, Dentist o AutomotiveBusiness. Un restaurante también puede agregar servesCuisine. Las coordenadas geográficas deben provenir de un geocodificador, no de una suposición, y los horarios deben coincidir con los que aparecen impresos en la página.
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"@id": "https://example.com/#localbusiness",
"name": "Example Bakery",
"image": "https://example.com/images/storefront.jpg",
"url": "https://example.com/",
"telephone": "+1-555-010-1000",
"priceRange": "$$",
"address": {
"@type": "PostalAddress",
"streetAddress": "100 Example Avenue",
"addressLocality": "Austin",
"addressRegion": "TX",
"postalCode": "78701",
"addressCountry": "US"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": 30.2672,
"longitude": -97.7431
},
"openingHoursSpecification": {
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"],
"opens": "07:00",
"closes": "18:00"
}
}El generador de schema de negocio local cubre los mismos campos. Una publicación solo en línea no tiene tienda física, así que Organization es el tipo adecuado en ese caso.
Ejemplos de producto y reseña
Una página de producto necesita el tipo Product con datos que coincidan con lo visible en la página. Obligatorio para esta función de Google (fragmento de producto): name, y al menos uno de review, aggregateRating u offers. Recomendado: image, description, brand y sku (documentación de Google sobre fragmentos de producto).
El precio y la disponibilidad van dentro del Offer anidado. Reemplace el precio, la moneda y el valor de availability por lo que la página del producto muestre hoy, y actualícelos cada vez que cambie la página.
{
"@context": "https://schema.org",
"@type": "Product",
"@id": "https://example.com/products/example-mug#product",
"name": "Example Ceramic Mug",
"image": [
"https://example.com/images/mug-front.jpg",
"https://example.com/images/mug-side.jpg"
],
"description": "Una taza de cerámica ficticia de 12 onzas.",
"sku": "EX-MUG-001",
"brand": {
"@type": "Brand",
"name": "Example Goods"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/products/example-mug",
"priceCurrency": "USD",
"price": "18.00",
"availability": "https://schema.org/InStock"
}
}Google distingue los fragmentos de producto de las fichas de comerciante en su documentación de datos estructurados de producto. Las fichas de comerciante usan propiedades adicionales dentro de offers, como shippingDetails e itemCondition, y Google recomienda gtin y hasMerchantReturnPolicy para ellas. Un Offer independiente y un AggregateRating independiente son tipos válidos de schema.org, pero Google usa las calificaciones dentro de los fragmentos de reseña y de producto, no como una función separada.
Use el generador de schema de producto para completar estos campos. Elija el tipo según el tema principal de la página: una página sobre un solo producto lleva Product, y una página sobre la empresa lleva Organization.
Un Review puede marcar una reseña que los visitantes pueden leer en la página. Obligatorio para esta función de Google (fragmento de reseña): author, reviewRating e itemReviewed. Recomendado: reviewBody, datePublished y publisher. No marque reseñas ocultas para los visitantes, y no marque reseñas en beneficio propio de su negocio, que las directrices de reseñas de Google restringen.
{
"@context": "https://schema.org",
"@type": "Review",
"@id": "https://example.com/reviews/example-mug-review#review",
"itemReviewed": {
"@type": "Product",
"name": "Example Ceramic Mug",
"url": "https://example.com/products/example-mug"
},
"author": {
"@type": "Person",
"name": "Jordan Example"
},
"datePublished": "2026-05-21",
"reviewBody": "La taza ficticia es resistente y cómoda de sostener.",
"reviewRating": {
"@type": "Rating",
"ratingValue": "5",
"bestRating": "5",
"worstRating": "1"
},
"publisher": {
"@type": "Organization",
"name": "Example Review Journal"
}
}El generador de schema de reseñas sigue la misma estructura. Reemplace el autor de la reseña, la fecha, el texto y la calificación por una reseña real que aparezca en su página, con las mismas palabras.
Ejemplos de artículo y ruta de navegación
Una página editorial usa Article, BlogPosting o NewsArticle. Google trata los tres como la función de Article. Google no enumera propiedades obligatorias para ella. Recomendadas para esta función de Google: headline, image, author, datePublished y dateModified. Opcionales: publisher y mainEntityOfPage (documentación de Google sobre artículos).
Para cambiar a una entrada de blog o a una noticia, cambie solo el valor de @type y los datos. Defina dateModified solo cuando la página haya cambiado realmente. El author aquí es un Person con un enlace a una página de autor, y el generador de schema de persona crea esa entidad si la quiere.
{
"@context": "https://schema.org",
"@type": "Article",
"@id": "https://example.com/articles/example-guide#article",
"headline": "Guía de ejemplo para mejores sitios web",
"image": [
"https://example.com/images/example-guide.jpg"
],
"datePublished": "2026-05-04T09:00:00-05:00",
"dateModified": "2026-05-18T09:00:00-05:00",
"author": {
"@type": "Person",
"name": "Alex Example",
"url": "https://example.com/authors/alex-example"
},
"publisher": {
"@type": "Organization",
"name": "Example Publishing",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/images/logo.png"
}
},
"mainEntityOfPage": "https://example.com/articles/example-guide"
}Pruebe el generador de schema de artículo para los mismos campos. BreadcrumbList describe la ruta desde la página de inicio hasta la página actual. Obligatorio para esta función de Google: itemListElement, con al menos dos objetos ListItem. Recomendado: position, name e item. La documentación de Google sobre ruta de navegación pide una ruta típica que podría seguir un visitante, así que haga coincidir la ruta que muestra su página.
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"@id": "https://example.com/blog/example-post#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Inicio",
"item": "https://example.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Blog",
"item": "https://example.com/blog/"
},
{
"@type": "ListItem",
"position": 3,
"name": "Entrada de ejemplo",
"item": "https://example.com/blog/example-post"
}
]
}El generador de schema de ruta de navegación numera las posiciones por usted.
Ejemplos de FAQPage, Event, VideoObject y Recipe
FAQPage es vocabulario válido de schema.org para preguntas y respuestas que los visitantes pueden leer en la página. Google dejó de mostrar resultados enriquecidos de preguntas frecuentes en mayo de 2026, así que el bloque no lleva a una visualización en la búsqueda. Consérvelo solo si quiere preguntas legibles por máquinas que coincidan con su texto visible. Google también retiró los resultados enriquecidos de HowTo, como describe su anuncio de agosto de 2023.
{
"@context": "https://schema.org",
"@type": "FAQPage",
"@id": "https://example.com/example-faq#faq",
"mainEntity": [
{
"@type": "Question",
"name": "¿Cuál es el área de entrega ficticia de Example Bakery?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Example Bakery entrega dentro del Example District ficticio."
}
},
{
"@type": "Question",
"name": "¿Ofrece Example Bakery productos ficticios sin gluten?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sí. Example Bakery ofrece un menú ficticio sin gluten."
}
}
]
}El generador de schema de preguntas frecuentes escribe la misma estructura. Cada name y cada text deben coincidir palabra por palabra con una pregunta y una respuesta que se muestren en la página.
Un Event necesita una fecha y un lugar. Obligatorio para esta función de Google: name, startDate y location. Recomendado: endDate, eventStatus, eventAttendanceMode, image, description, offers, performer y organizer (documentación de Google sobre eventos). Para un evento en línea, defina eventAttendanceMode como OnlineEventAttendanceMode y use un VirtualLocation con una URL como ubicación. El generador de schema de evento ofrece ambas formas.
{
"@context": "https://schema.org",
"@type": "Event",
"@id": "https://example.com/events/example-workshop#event",
"name": "Taller de ejemplo sobre sitios web",
"description": "Un taller ficticio sobre cómo crear mejores sitios web.",
"image": "https://example.com/images/workshop.jpg",
"startDate": "2026-12-05T10:00:00-06:00",
"endDate": "2026-12-05T12:00:00-06:00",
"eventStatus": "https://schema.org/EventScheduled",
"eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
"location": {
"@type": "Place",
"name": "Example Community Hall",
"address": {
"@type": "PostalAddress",
"streetAddress": "500 Example Lane",
"addressLocality": "Austin",
"addressRegion": "TX",
"postalCode": "78705",
"addressCountry": "US"
}
},
"organizer": {
"@type": "Organization",
"name": "Example Academy",
"url": "https://example.com/"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/events/example-workshop",
"price": "25.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}Una página de video usa VideoObject. Obligatorio para esta función de Google: name, thumbnailUrl y uploadDate. Recomendado: description, contentUrl, embedUrl, duration y expires (documentación de Google sobre videos). El valor de duration usa ISO 8601, así que PT8M30S significa ocho minutos y treinta segundos.
{
"@context": "https://schema.org",
"@type": "VideoObject",
"@id": "https://example.com/videos/example-tutorial#video",
"name": "Tutorial de ejemplo sobre sitios web",
"description": "Un tutorial ficticio que muestra cómo organizar un sitio web.",
"thumbnailUrl": [
"https://example.com/images/example-tutorial-thumbnail.jpg"
],
"uploadDate": "2026-05-04T09:00:00-05:00",
"duration": "PT8M30S",
"contentUrl": "https://cdn.example.com/videos/example-tutorial.mp4",
"embedUrl": "https://example.com/videos/example-tutorial/embed"
}Una página de receta usa Recipe. Obligatorio para esta función de Google: name e image. Recomendado: recipeIngredient, recipeInstructions, author, datePublished, description, prepTime, cookTime, totalTime, recipeYield, nutrition, aggregateRating y video (documentación de Google sobre recetas). Si agrega una calificación, incluya ratingValue y ratingCount o reviewCount, y solo cuando la página muestre calificaciones reales.
{
"@context": "https://schema.org",
"@type": "Recipe",
"@id": "https://example.com/recipes/example-bread#recipe",
"name": "Pan de plátano de ejemplo",
"image": ["https://example.com/images/banana-bread.jpg"],
"author": {
"@type": "Person",
"name": "Alex Example"
},
"datePublished": "2026-05-06",
"description": "Una receta ficticia de pan de plátano.",
"prepTime": "PT15M",
"cookTime": "PT45M",
"totalTime": "PT1H",
"recipeYield": "1 pan",
"recipeIngredient": [
"3 plátanos maduros ficticios",
"200 g de harina ficticia",
"100 g de azúcar ficticia"
],
"recipeInstructions": [
{
"@type": "HowToStep",
"text": "Aplaste los plátanos ficticios."
},
{
"@type": "HowToStep",
"text": "Mezcle los ingredientes y hornee hasta que estén listos."
}
],
"nutrition": {
"@type": "NutritionInformation",
"calories": "220 calorías por rebanada"
}
}Ejemplos de servicio y grafo conectado
Service es vocabulario válido de schema.org para una página de servicio, y ningún resultado enriquecido de Google está asociado a un Service genérico. Las propiedades útiles son name, description, serviceType, provider, areaServed y offers. El generador de schema de servicio lo crea, y el proveedor debe ser la misma organización que describió en otro lugar.
{
"@context": "https://schema.org",
"@type": "Service",
"@id": "https://example.com/services/example-consulting#service",
"name": "Consultoría de ejemplo sobre sitios web",
"description": "Un servicio ficticio de consultoría para planificar sitios web.",
"serviceType": "Consultoría de sitios web",
"provider": {
"@type": "Organization",
"name": "Example Studio",
"url": "https://example.com/"
},
"areaServed": {
"@type": "AdministrativeArea",
"name": "Example County"
},
"offers": {
"@type": "Offer",
"price": "250.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}Según la documentación de Google sobre nombres de sitio, el marcado de WebSite sigue siendo útil para los nombres de sitio. El cuadro de búsqueda de enlaces de sitio que antes alimentaba ese marcado se retiró de la Búsqueda de Google a partir del 21 de noviembre de 2024 (Blog de Google Search Central).
Cuando una página describe varias cosas relacionadas, colóquelas en un solo @graph y conéctelas con @id. El bloque siguiente conecta una empresa, un artículo que publicó y la ruta de navegación. Cada elemento conserva las propiedades obligatorias de su propia función, y publisher apunta a la organización con una referencia breve {"@id": ...} en lugar de repetirla. La especificación JSON-LD 1.1 define los identificadores y los grafos, y las directrices de Google permiten conectar elementos relacionados.

{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Example Publishing",
"url": "https://example.com/",
"logo": "https://example.com/images/logo.png"
},
{
"@type": "BlogPosting",
"@id": "https://example.com/blog/example-post#article",
"headline": "Guía de Example Publishing",
"image": "https://example.com/images/example-post.jpg",
"datePublished": "2026-05-04T09:00:00-05:00",
"dateModified": "2026-05-12T09:00:00-05:00",
"author": { "@type": "Person", "name": "Alex Example" },
"publisher": { "@id": "https://example.com/#organization" },
"mainEntityOfPage": "https://example.com/blog/example-post"
},
{
"@type": "BreadcrumbList",
"@id": "https://example.com/blog/example-post#breadcrumb",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://example.com/" },
{ "@type": "ListItem", "position": 2, "name": "Guía de Example Publishing", "item": "https://example.com/blog/example-post" }
]
}
]
}El Schema Graph Builder conecta entidades de esta manera sin que tenga que escribir cada referencia a mano.
Agregue el bloque en su plataforma
Sea cual sea la plataforma, el resultado final es el mismo elemento script con el mismo JSON. En HTML simple, el bloque se pega tal como está, en el head o en el body.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Example Bakery"
}
</script>En WordPress, arme los datos como un arreglo de PHP y deje que wp_json_encode() lo convierta en JSON (referencia para desarrolladores de WordPress). La marca JSON_HEX_TAG evita que una etiqueta suelta dentro de un valor cierre el script antes de tiempo. El fragmento siguiente es un punto de partida para un tema hijo o un plugin de fragmentos de código, así que agregue las demás propiedades de Article del ejemplo anterior antes de confiar en él, y desactive cualquier salida duplicada de su plugin de SEO.
add_action( 'wp_head', function () {
if ( ! is_singular( 'post' ) ) {
return;
}
$data = array(
'@context' => 'https://schema.org',
'@type' => 'Article',
'headline' => get_the_title(),
);
echo '<script type="application/ld+json">' . wp_json_encode( $data, JSON_HEX_TAG ) . '</script>';
} );Wix acepta JSON-LD para el marcado manual y limita cada bloque a 7,000 caracteres, así que un grafo largo quizá deba dividirse. En Webflow, el campo de schema está en «Page Settings» (configuración de página); agregue el schema allí, publique la página y luego pruébela. En Squarespace y Shopify, revise primero la salida automática y agregue un bloque solo para lo que la plataforma no incluya. En HubSpot, siga la documentación vigente de HubSpot o revise el código fuente de la página publicada antes de agregar marcado personalizado.
En Next.js, muestre el script desde layout.js o page.js, y escape el signo de menor que en los valores serializados, como recomienda la guía de JSON-LD de Next.js.
export default function Page() {
const jsonLd = {
'@context': 'https://schema.org',
'@type': 'Article',
headline: 'Guía de ejemplo para mejores sitios web',
};
return (
<script
type="application/ld+json"
dangerouslySetInnerHTML={{
__html: JSON.stringify(jsonLd).replace(/</g, '\\u003c'),
}}
/>
);
}Pruebe la página publicada
Pruebe en este orden. Primero lea el código fuente renderizado de la página en vivo y confirme que el bloque está presente, aparece una vez por entidad y contiene sus valores. Después ejecute la Prueba de resultados enriquecidos de Google (Rich Results Test) en la URL publicada. Esa prueba lee JSON-LD, RDFa y Microdata, y reporta errores y sugerencias para los tipos de resultado compatibles.
El validador de Schema Nova revisa el código pegado y el comprobador de schema lee una dirección de página. Si una prueba muestra una advertencia sobre un campo que falta, revise si el campo es recomendado u obligatorio para esa función de Google antes de agregar nada.
Una prueba aprobada muestra que el marcado se procesa correctamente y que, en las funciones compatibles, podría ser apto. No garantiza que Google vaya a mostrar un resultado. Elimine cualquier bloque duplicado que encuentre, publique de nuevo y vuelva a probar. Después, Google Search Console puede informar con el tiempo los datos estructurados que encuentra en su sitio.
Preguntas frecuentes
¿Dónde debe ir el JSON-LD en el HTML?
Coloque el elemento script en el HTML de la página que describe, en el head o en el body. Después de publicar, vea el código fuente de la página y confirme que el bloque aparece en el HTML renderizado.
¿Un JSON-LD válido garantiza un resultado enriquecido?
No. Google indica que el marcado correcto no garantiza un resultado enriquecido, y una prueba aprobada en la Prueba de resultados enriquecidos muestra señales de elegibilidad, no una promesa de que se muestre. Un JSON-LD válido aún puede ayudar a las máquinas a leer la página.
¿Una página puede incluir más de un tipo de schema?
Sí. Una página de producto puede describir un Product, un BreadcrumbList y la Organization que está detrás. Coloque los elementos relacionados en un solo @graph, conéctelos con @id y mantenga cada descripción coherente con la página visible.
¿Puedo usar marcado FAQPage en un sitio de negocio?
Es vocabulario válido de schema.org para preguntas y respuestas que aparecen en la página. Google dejó de mostrar resultados enriquecidos de preguntas frecuentes en mayo de 2026, así que trate el bloque como texto legible por máquinas, no como una forma de obtener una visualización.
¿Cómo evito el marcado duplicado de un plugin o de una plataforma?
Vea el código fuente de la página publicada y busque ld+json antes de agregar nada. Si un tema, un plugin o una plataforma ya describe la misma entidad, edite esa salida o desactive la duplicada, y luego pruebe la página de nuevo.
