¿Qué es ItemList en Schema.org?

Una página de categoría, una lista de «los más vendidos» o una guía con los diez mejores productos para algo tienen una cosa en común: son listas. ItemList es el tipo de Schema.org que las describe en los datos estructurados de la página. No hay que confundirlo con las listas de HTML, las de viñetas, que el propio vocabulario distingue porque muchas veces solo sirven para maquetar.⁠^{[1]Schema.org. ItemList} Te importa porque las categorías son las páginas de una tienda que más a menudo se quedan sin marcado, porque ItemList es el tipo que les corresponde y porque es fácil esperar de él más de lo que Google hace con él.

Cómo funciona

Una lista se describe con tres propiedades propias de ItemList:⁠^{[1]Schema.org. ItemList}

• itemListElement, los elementos. Pueden ser textos sueltos («Pedro», «Pablo», «María»), entidades ya descritas o nodos ListItem. Schema.org recomienda los textos para listas de palabras, las entidades para una lista simple y sin orden, y ListItem para las listas ordenadas o cuando un mismo elemento puede estar en sitios distintos de listas distintas.
• itemListOrder, el tipo de orden: ascendente, descendente o sin orden.
• numberOfItems, cuántos elementos tiene la lista. Si la página solo muestra una parte, como en una categoría paginada, el número es el de la lista entera.

El vocabulario añade un aviso que cambia cómo se escribe el marcado: el orden de los elementos en el código no basta para indicar el orden de la lista. Para eso está ListItem con su propiedad position.⁠^{[1]Schema.org. ItemList} Cada ListItem lleva la posición, el elemento en sí (item) y, si hace falta, enlaces al anterior y al siguiente (previousItem y nextItem).⁠^{[2]Schema.org. ListItem}

ItemList tiene un subtipo que casi todas las tiendas ya publican sin saberlo: BreadcrumbList, el de las migas de pan, que Schema.org define como un ItemList formado por una cadena de páginas enlazadas.⁠^{[3]Schema.org. BreadcrumbList} Schema.org calcula que ItemList lo usan entre uno y diez millones de dominios, con datos del índice de Google de agosto de 2026.⁠^{[1]Schema.org. ItemList}

Qué hace Google con una lista marcada

Google usa ItemList para uno de sus resultados enriquecidos: el carrusel, una fila de tarjetas de un mismo sitio que se desliza en horizontal. Tiene dos documentos distintos, y conviene no mezclarlos.

El carrusel general combina ItemList con una de cuatro clases de contenido: cursos, películas, recetas o restaurantes. Admite dos formas de página: una de resumen, donde cada ListItem lleva solo @type, position y url, y cada URL apunta a una página distinta del mismo dominio; o una página que lo contiene todo, donde las URL apuntan a anclas de la propia página. Pide al menos dos ListItem, todos del mismo tipo.⁠^{[4]Google Search Central. Carousel (ItemList) structured data} Los productos no están en esa lista.

Los productos están en el segundo: un carrusel en beta que combina ItemList con Product, con negocios locales o con eventos, y que puede enseñar en cada tarjeta el precio, la valoración y las imágenes. Solo existe en los países del Espacio Económico Europeo, España incluida, en Turquía y en Sudáfrica, y en Turquía no cubre productos. Para las consultas de productos en los países del programa de servicios de comparación de precios (CSS), la documentación remite a empezar por ese programa.⁠^{[5]Google Search Central. Structured data carousels (beta)} Las condiciones que fija, según su versión del 11 de septiembre de 2026:⁠^{[5]Google Search Central. Structured data carousels (beta)}

• El marcado va en una página de resumen o de categoría con al menos tres elementos, que enlaza a otras páginas del mismo sitio. Una página que lo contiene todo no sirve.
• Se marcan todos los elementos que muestra la página. En una categoría paginada, cada página lleva su ItemList con lo que muestra; con scroll infinito, lo que se carga al principio.
• Cada elemento necesita name, image y url. Para un producto se recomienda offers con price y priceCurrency, y si falta la moneda, Google da por hecho que son dólares.
• El orden del marcado es el orden de las tarjetas.

Y una cosa que ItemList no hace: convertir una categoría en ficha. Los resultados de producto de Google solo admiten páginas centradas en un solo producto (o en variantes del mismo), y Google recomienda marcar las fichas y no las páginas que listan productos o una categoría.⁠^{[6]Google Search Central. Merchant listing (Product, Offer) structured data}

En una tienda

Ejemplo ficticio. La primera página de la categoría «Camisas de lino» de Calella, una tienda inventada, con 14 camisas repartidas en cinco páginas de tres. El bloque, recortado a dos elementos:

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "numberOfItems": 14,
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "Product",
        "name": "Camisa de lino Calella, azul",
        "image": "https://www.example.com/img/calella-azul.jpg",
        "url": "https://www.example.com/camisa-lino-calella",
        "offers": { "@type": "Offer", "price": "39.90", "priceCurrency": "EUR" }
      }
    },
    {
      "@type": "ListItem",
      "position": 2,
      "item": {
        "@type": "Product",
        "name": "Camisa de lino Calella, blanca",
        "image": "https://www.example.com/img/calella-blanca.jpg",
        "url": "https://www.example.com/camisa-lino-calella-blanca",
        "offers": { "@type": "Offer", "price": "39.90", "priceCurrency": "EUR" }
      }
    }
  ]
}

Se lee así. numberOfItems dice 14 aunque la página enseñe tres, porque cuenta la lista entera. Cada ListItem tiene su position, y cada producto, las tres propiedades que exige el carrusel en beta y una Offer con la moneda escrita. Las URL llevan a las fichas, en el mismo dominio. La página 2 llevaría su propio bloque con sus tres camisas.

Para ver qué trae un tema de serie, se pueden leer sus plantillas. Cornerstone, el tema por defecto de BigCommerce, publicó su versión 6.22.0 el 21 de septiembre de 2026: en ella, el bloque JSON-LD de Product va en la ficha y el de BreadcrumbList en las migas, y ninguna plantilla incluye ItemList.⁠^{[7]BigCommerce en GitHub. Cornerstone, the default Stencil theme (release 6.22.0)} En una tienda con ese tema, la categoría solo describe dónde está, no qué contiene.

Cómo comprobarlo

1. Abre el código fuente de una categoría y busca ItemList. Si no aparece, mira qué hay: muchas veces solo están las migas de pan.
2. Cuenta los elementos del marcado y los productos que ves. Deben coincidir: Google pide marcar todo lo que la página muestra, y en la página 2, lo de la página 2.⁠^{[5]Google Search Central. Structured data carousels (beta)}
3. Repasa cada ListItem: una position que empieza en 1 y no se repite, y una url que lleva a una ficha de tu dominio.⁠^{[1]Schema.org. ItemList}⁠^{[5]Google Search Central. Structured data carousels (beta)}
4. Mira el precio de cada producto: price con punto decimal y priceCurrency en EUR. Sin moneda, Google asume dólares.⁠^{[5]Google Search Central. Structured data carousels (beta)}
5. Comprueba que la categoría no lleva un bloque Product como si fuera una ficha. Los resultados de producto son para páginas de un solo producto.⁠^{[6]Google Search Central. Merchant listing (Product, Offer) structured data}

Concepto cercano: migas de pan (BreadcrumbList)

Las migas de pan y la lista de productos son las dos listas que lleva una categoría, y las dos se marcan con la familia ItemList. Pero dicen cosas distintas. BreadcrumbList es una cadena de páginas enlazadas que suele terminar en la página actual, con la portada o la sección al principio y position para reconstruir el orden.⁠^{[3]Schema.org. BreadcrumbList} Las migas dicen dónde está la página; el ItemList de la categoría dice qué contiene. Una categoría puede, y suele deber, llevar las dos.

Para seguir, la ruta de lectura de datos estructurados ordena el resto de términos, y la entrada de PLP explica lo demás que necesita una página de listado: la paginación, los filtros y qué se indexa.