# ItemList en Schema.org: el marcado de las listas

> Qué es ItemList en Schema.org, cómo se ordena con ListItem, qué carruseles de Google lo usan con productos y cómo revisar el de tus categorías.

URL: https://clione.ai/es/glosario/itemlist/
Lang: es

Una [página de categoría](/es/glosario/pagina-de-categoria/), 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](/es/glosario/schema-org/) que las describe en los [datos estructurados](/es/glosario/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.[^schema-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:[^schema-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`.[^schema-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`).[^schema-listitem]

ItemList tiene un subtipo que casi todas las tiendas ya publican sin saberlo: BreadcrumbList, el de las [migas de pan](/es/glosario/migas-de-pan/), que Schema.org define como un ItemList formado por una cadena de páginas enlazadas.[^schema-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.[^schema-itemlist]

## Qué hace Google con una lista marcada

Google usa ItemList para uno de sus [resultados enriquecidos](/es/glosario/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.[^google-carousel] **Los productos no están en esa lista.**

Los productos están en el segundo: **un carrusel en beta** que combina ItemList con [Product](/es/glosario/schema-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.[^google-carousels-beta] Las condiciones que fija, según su versión del 11 de septiembre de 2026:[^google-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.[^google-merchant-listing]

## 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:

```json
{
  "@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](/es/glosario/schema-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](/es/glosario/json-ld/) de Product va en la ficha y el de BreadcrumbList en las migas, y **ninguna plantilla incluye ItemList**.[^cornerstone-repo] En una tienda con ese tema, la categoría solo describe dónde está, no qué contiene.


Creer que añadir ItemList a una categoría basta para salir en un carrusel de Google. Para productos, el único carrusel que lo admite está en beta y solo en el Espacio Económico Europeo y en Sudáfrica, pide al menos tres elementos con nombre, imagen y URL, y Google puede cambiar sus requisitos mientras siga en beta.[^google-carousels-beta] Fuera de esos países, una categoría bien marcada con ItemList describe la página, pero no tiene un resultado enriquecido de producto que activar.[^google-carousel]


## 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.[^google-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.[^schema-itemlist][^google-carousels-beta]
4. **Mira el precio de cada producto**: `price` con punto decimal y `priceCurrency` en EUR. Sin moneda, Google asume dólares.[^google-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.[^google-merchant-listing]

## 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.[^schema-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](/es/aprender/datos-estructurados/) ordena el resto de términos, y la entrada de [PLP](/es/glosario/plp/) explica lo demás que necesita una página de listado: la paginación, los filtros y qué se indexa.