¿Cuál es la diferencia entre una colección manual y una automática en VTEX?

En una colección manual tú decides exactamente qué productos entran: los agregas uno a uno o por importación, y nada cambia hasta que alguien la edite. En una automática defines reglas (por ejemplo, marca o categoría) y la colección se llena y actualiza sola cuando el catálogo cambia. Las manuales dan control total pero exigen mantenimiento constante, por eso son las que más trabajo operativo generan en campañas. Las automáticas convienen para agrupaciones estructurales y estables. Si gestionas muchas colecciones manuales, una herramienta como VTEX Reemplazar permite actualizarlas de forma masiva con un CSV en lugar de producto por producto.

¿Por qué mi colección VTEX no aparece en el sitio?

Las causas más comunes son cinco: la colección existe pero ningún componente del storefront la está consumiendo (crearla no la publica sola); el indexador todavía no procesó los cambios, porque en VTEX no se reflejan al instante; la colección está fuera de su periodo de vigencia, si tu versión del módulo maneja fechas; los productos están inactivos, invisibles o sin stock, y por eso la vitrina los omite; o el ID configurado en la vitrina o landing no coincide con el de la colección. Revisa en ese orden: vínculo con el storefront, indexación, vigencia, estado de los productos e ID.

¿Cómo agrego o quito cientos de productos de una colección VTEX sin hacerlo uno por uno?

Tienes dos caminos. Dentro del admin de VTEX, algunas versiones del módulo de colecciones permiten importar productos por archivo, lo que resuelve la carga inicial. Para el mantenimiento continuo, VTEX Reemplazar de Clico te deja subir un CSV con los SKU IDs que quieres en la colección, ver un preview de qué se agrega, qué se quita y qué se mantiene, y aplicar los cambios vía la API de VTEX con un clic. Y para vaciar colecciones completas al cierre de una campaña, VTEX Limpiar procesa varias colecciones a la vez, mostrando cuántos productos tiene cada una antes de confirmar.

¿Cómo mido las ventas que genera una colección VTEX?

La colección en sí no trae analítica: lo que mides es el tráfico hacia la landing o vitrina que la consume. Etiqueta cada enlace de campaña (ads, email, WhatsApp, redes) con parámetros UTM para ver en tu herramienta de analítica qué canal trajo cada visita y conversión; en qué son los UTM está la base completa. Si vendes en VTEX, suma los parámetros internos de la plataforma (utmi_cp, utmi_pc, utmi_p), que el UTM Builder de Clico incluye junto a los cinco UTM estándar, con plantillas e historial para mantener consistencia entre campañas.

Colecciones VTEX: guía completa para crearlas, mantenerlas y automatizarlas

Una colección VTEX es una agrupación de productos que defines en el catálogo para mostrarlos juntos en vitrinas, landings de promoción o campañas de temporada. Puede ser manual (eliges los productos uno a uno o por importación) o automática (se llena sola según reglas como marca o categoría), y es la base de casi cualquier acción comercial en una tienda VTEX.

Si administras una tienda VTEX, las colecciones son probablemente la parte del admin donde más horas operativas se te van cada mes. Esta guía cubre qué son, cómo crearlas, por qué a veces "no funcionan", cómo nombrarlas para no perderte, y cómo sacarte de encima la parte masiva del trabajo.

¿Qué es una colección en VTEX y para qué sirve?

En VTEX, una colección (también llamada cluster de productos) es una lista de productos agrupados bajo un ID. La colección en sí no se ve en el sitio: es un contenedor. Lo que se ve son los componentes del storefront que consumen ese ID: un estante en la home, una landing de campaña, un resultado de búsqueda filtrado.

Los usos típicos son cuatro:

Vitrinas de la home o de categoría ("Lo nuevo", "Ofertas de la semana").
Landings de campaña (Cyber, Día de la Madre, Navidad) que muestran solo los productos seleccionados.
Selecciones editoriales ("Regalos hasta S/100", "Esenciales de invierno").
Agrupaciones operativas que el cliente no ve: productos por liquidar, lanzamientos del mes, o el conjunto de productos al que apunta una promoción.

Ese último punto es clave: en VTEX puedes condicionar promociones a una colección, así que una colección bien mantenida también es una promoción bien acotada.

¿Cuál es la diferencia entre colección manual y automática?

Criterio	Colección manual	Colección automática
Cómo se llena	Agregas productos uno a uno o por importación	Se llena sola según reglas (marca, categoría, etc.)
Control	Total: decides exactamente qué entra	Parcial: entra todo lo que cumpla la regla
Mantenimiento	Alto: cada cambio es trabajo manual	Bajo: se actualiza cuando el catálogo cambia
Ideal para	Campañas curadas, selecciones comerciales	Agrupaciones estructurales y estables

La regla práctica: usa automáticas para todo lo que pueda expresarse como una regla estable ("toda la marca X", "toda la categoría Y en oferta") y manuales solo cuando la selección es curada. Casi todos los dolores de cabeza vienen de las manuales, porque cada campaña implica cargarlas, ajustarlas a diario y desarmarlas al final.

¿Cómo crear una colección en VTEX?

VTEX ha tenido más de una versión de su módulo de colecciones, así que las pantallas exactas varían según tu tienda. El flujo funcional, sin embargo, es siempre el mismo:

Entra al módulo de colecciones del admin y crea una nueva con un nombre descriptivo (abajo hay una convención sugerida).
Si tu versión del módulo maneja fechas de vigencia, configúralas según la duración de la campaña.
Agrega productos: uno a uno, por importación de archivo, o mediante reglas si es automática.
Guarda y anota el ID que VTEX le asigna a la colección.
Vincula ese ID al componente del storefront que la va a mostrar: vitrina, estante o landing. Sin este paso, la colección existe pero no se ve en ningún lado.
Espera la indexación y verifica en el sitio. Los cambios de catálogo en VTEX no se reflejan al instante.

¿Cómo es el flujo real de un e-commerce manager con colecciones?

El ciclo de una campaña casi siempre se ve así:

Comercial define la selección y te llega un Excel con cientos de SKUs.
Creas la colección y cargas los productos.
La vinculas a la landing o vitrina y haces QA antes del lanzamiento.
Durante la campaña llegan cambios diarios: productos que se agotan, entradas de último minuto, SKUs que comercial decide sacar.
Al cierre hay que desarmar todo: vaciar o retirar la colección para que la landing no siga mostrando una campaña vencida.

El problema nunca es crear la colección: es mantenerla. Agregar y quitar productos uno por uno consume horas cuando la selección cambia a diario, las colecciones de temporada se reciclan de un año a otro sin criterio, y la limpieza post-campaña es la tarea que nadie hace, lo que deja colecciones zombis acumulándose en el admin.

A eso se suma la medición. Si la landing de la colección recibe tráfico de ads, email y WhatsApp, necesitas etiquetar cada enlace con parámetros UTM para saber qué canal funcionó; la base está explicada en qué son los UTM. VTEX además usa parámetros internos propios (utmi_cp, utmi_pc, utmi_p) que conviene incluir en los enlaces de campaña; el UTM Builder de Clico los soporta junto a los cinco UTM estándar, con plantillas e historial.

¿Por qué mi colección VTEX no funciona o no se ve?

Cuando una colección "no funciona", la causa suele estar en esta lista. Revisa en orden:

Nada la consume: crear la colección no la publica. Algún componente del storefront debe estar configurado con su ID.
Indexación pendiente: los cambios tardan en reflejarse mientras el indexador procesa. Antes de tocar nada más, dale tiempo y vuelve a verificar.
Fuera de vigencia: si tu versión del módulo maneja fechas de inicio y fin, una colección vencida deja de mostrarse aunque tenga productos.
Productos no elegibles: las vitrinas solo muestran productos activos, visibles y con stock disponible. Una colección llena de productos agotados se ve vacía.
ID equivocado: un dígito mal copiado en la configuración de la vitrina o landing y estarás mostrando otra colección (o ninguna).
Configuración de visibilidad de la propia colección: según la versión del módulo, existen opciones que controlan si la colección aplica a búsquedas o solo a destacados. Verifícalas si todo lo anterior está bien.

¿Qué buenas prácticas de nomenclatura conviene usar?

Con decenas de colecciones acumuladas, el nombre es tu único índice. Una convención simple que funciona:

[AÑO]-[CAMPAÑA]-[SEGMENTO]-[USO]

2026-CYBER-ZAPATILLAS-LANDING 2026-CYBER-ZAPATILLAS-HOME 2026-DIAMADRE-REGALOS-VITRINA PERM-MARCA-NIKE-AUTO ```

Cuatro reglas acompañan la convención: el año primero, para que el orden alfabético agrupe por temporada; un sufijo de uso (LANDING, HOME, VITRINA, PROMO) porque una misma campaña suele necesitar varias colecciones; prefijo PERM para las permanentes, que nadie debe vaciar en una limpieza; y nunca reciclar una colección vieja renombrándola, porque pierdes el historial de qué mostró cada campaña.

¿Cómo automatizar la parte masiva de las colecciones?

Somos los creadores de Clico, así que esta parte tómala como lo que es: nuestra propuesta, con sus razones. Clico nació justamente de esta fricción: lo creó un e-commerce manager en Perú cansado de mantener colecciones a mano, y sus tres herramientas VTEX atacan cada etapa del ciclo:

VTEX Gestor lista todas tus colecciones en una sola tabla: nombre, ID, tipo (manual o automática), cantidad de productos y fechas, con filtros y export a CSV. Es la forma rápida de auditar colecciones zombis y de encontrar el ID que necesitas sin navegar el admin.
VTEX Reemplazar convierte el Excel de comercial en la fuente de verdad: subes un CSV con los SKU IDs que deben estar en la colección, ves un preview de qué se agrega, qué se quita y qué se mantiene, y aplicas los cambios vía la API de VTEX con un clic.
VTEX Limpiar resuelve el cierre de campaña: ingresas uno o varios IDs de colección separados por comas, ves cuántos productos tiene cada una y las vacías en segundos.

Las credenciales VTEX (App Key y App Token) se guardan cifradas, puedes conectar múltiples cuentas, y la configuración está explicada en la documentación. Al momento de escribir (julio 2026), todo es gratis durante la Beta; el plan Pro cuesta USD 5 al mes, o S/19 con Yape en Perú.

Las colecciones son de esas piezas de VTEX que parecen triviales hasta que gestionas veinte a la vez en plena campaña. Con tipos bien elegidos, nombres consistentes y la parte masiva automatizada, dejan de ser un cuello de botella y vuelven a ser lo que deberían: la forma más rápida de poner una selección comercial frente al cliente.