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.

Puntos clave

  1. Elija un ejemploElija el ejemplo que coincida con la página, reemplace cada valor ficticio por un dato de su propia página, añada un bloque y pruebe la URL publicada.
  2. Compruebe primero lo que existeRevise el HTML de la página en busca de ld+json. Si un tema, complemento o plataforma ya describe la entidad, edite esa salida, no añada una segunda descripción.
  3. Coincida con la página visibleGoogle indica que el marcado debe representar el contenido que los visitantes pueden ver. Una valoración, precio, evento o autor que aparece solo en el código no pertenece allí.
  4. Nombre la función de GoogleLos requisitos corresponden a una función específica de Google. Un vocabulario válido de schema.org puede no tener ninguna función detrás, y un marcado correcto no garantiza un resultado enriquecido.
  5. Trate FAQPage como vocabularioFAQPage es vocabulario válido de schema.org, pero Google dejó de mostrar resultados enriquecidos de preguntas frecuentes en mayo de 2026. Consérvelo solo para preguntas y respuestas visibles en la página.
  6. Pruebe la página publicadaConfirme que el bloque aparece una vez por entidad en el HTML renderizado, y luego ejecute la Prueba de resultados enriquecidos. Superarla no garantiza que Google muestre un resultado.

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.

Dos colegas en una mesa de reunión con computadoras portátiles, una señala la pantalla mientras el otro mira la suya
Figura 1. Leer la página y el código lado a lado muestra qué valores coinciden y cuáles aún deben reemplazarse.

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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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.

json
{
  "@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"
  }
}

Propiedades obligatorias y recomendadas por función de Google

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

TipoObligatorio para esta función de GoogleRecomendado
OrganizationNingunaname, url, logo, sameAs
LocalBusinessname, addressimage, url, telephone, horario de apertura
Product (fragmento de producto)name, además de review, aggregateRating u offersimage, description, brand, sku
ArticleNingunaheadline, image, author, datePublished, dateModified
Eventname, startDate, locationendDate, offers, performer
Recipename, imageingredientes, instrucciones, tiempos, rendimiento, nutrición, calificación

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.

json
{
  "@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.

Cuatro formas redondeadas unidas por líneas azules en un solo grupo dentro de un anillo tenue
Figura 2. Un grafo conecta una empresa, un artículo y una ruta de migas de pan mediante identificadores compartidos.
json
{
  "@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.

html
<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.

php
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.

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.

Del ejemplo al marcado publicado

  1. Elija el temaElija el tipo que corresponde a lo que trata principalmente la página.
  2. Reúna los datos visiblesReúna nombres, precios, fechas y datos de contacto que aparecen en la página.
  3. Copie un ejemploParta de un bloque completo y reemplace cada valor ficticio.
  4. Agregue el scriptColoque un solo bloque en la página, después de revisar si ya existe código.
  5. Publique y pruebeEjecute la Prueba de resultados enriquecidos en la URL publicada.
  6. Quite los duplicadosCorrija los errores, elimine los bloques repetidos y luego supervise Search Console.

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.

Revisión rápida

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

¿Garantiza un JSON-LD válido un resultado enriquecido?

Pregunta 2 de 3

¿Una propiedad recomendada siempre es obligatoria?

Pregunta 3 de 3

¿Puede un sitio marcar una reseña oculta para los visitantes?

Términos usados en los ejemplos

Seleccione un término para ver su definición.

JSON-LD. Un formato basado en JSON para datos vinculados, colocado en un elemento script.