Pintura al óleo en azul: tech lead de front-end con una taza en la mano revisa código en dos monitores, de noche
  1. Inicio
  2. Migraciones
  3. Migración VTEX CMS → VTEX IO

Del VTEX CMS heredado a VTEX IO.

Llevamos tu storefront del CMS Portal a VTEX IO y FastStore, con catálogo, checkout y operación mantenidos en la misma cuenta y Core Web Vitals al nivel actual.

Cambia el storefront, el core de VTEX se queda

Catálogo, pedidos, checkout, promociones, pagos y logística siguen en la misma cuenta. La migración cambia solo la capa de experiencia.

  • Solo migra el storefront: catálogo y checkout quedan como están.
  • FastStore con SSG y SSR, imágenes optimizadas y meta de LCP móvil por debajo de 2,5 s.
  • SEO, slugs y autoridad de dominio preservados.
  • Design system reutilizable en React y TypeScript.
  • Hoja de ruta clara para salir del sistema heredado en 3 a 5 meses.

Por qué salir del VTEX CMS ahora

La propia VTEX orienta la innovación hacia IO y FastStore. Cada año en Portal amplía la distancia.

El CMS Portal es heredado

Los nuevos proyectos y la innovación de VTEX van a IO y FastStore. Quedarse en Portal es perder acceso a apps modernas, Intelligent Search, headless e integraciones recientes.

Core Web Vitals deficientes

Las plantillas de Portal cargan CSS y JS pesados, renderizan en el servidor con caché limitada y dificultan las métricas en verde en móvil, lo que afecta a Google Ads, el SEO y la conversión.

Baja productividad

Los cambios simples pasan por varias pantallas, HTML acoplado a las plantillas y despliegue manual. En IO y FastStore, el design system y el CI/CD aceleran cada entrega.

SEO técnico limitado

Portal ofrece poco control sobre metadatos dinámicos, datos estructurados, sitemap y rendimiento. IO y FastStore ofrecen SSR, SSG, JSON-LD nativo y control total del HTML.

Un mercado cada vez más headless

Las tiendas headless ya operan con PWA, personalización y pruebas A/B nativas. Personalizar el sistema heredado no cierra esa distancia.

El futuro del talento

Los profesionales nuevos prefieren React y TypeScript en FastStore a las plantillas antiguas de Portal. Migrar amplía el pool de talento y facilita la contratación.

Seis fases, cada una con un punto de decisión

Foco en el storefront, preservando el catálogo y el checkout que ya funcionan en VTEX, con entregables objetivos y aprobación conjunta al final de cada fase.

  1. 1

    Diagnóstico

    Plantillas, apps personalizadas, volumen de páginas, rendimiento, SEO e integraciones de front, como analítica, personalización y pruebas A/B. Resultado: mapa de alcance y recomendación.

  2. 2

    Planificación

    Arquitectura FastStore, design system, matriz de páginas, SEO, plan de contenido y cronograma. Resultado: blueprint aprobado y kickoff.

  3. 3

    Setup

    Proyecto FastStore, workspace IO, repositorios, pipelines, accesos y entornos. Resultado: stack lista para el desarrollo continuo.

  4. 4

    Desarrollo

    Design system en React y TypeScript, home, PLP, PDP y páginas institucionales, Intelligent Search, ajustes ligeros de checkout y pruebas de rendimiento y accesibilidad.

  5. 5

    Cutover

    Workspace master en producción, ruta de los dominios cambiada a FastStore, redirecciones 301 activas y apagado gradual de Portal. Inactividad efectiva cercana a cero.

  6. 6

    Hypercare

    De 30 a 60 días de ajuste fino de Core Web Vitals, seguimiento de SEO y conversión, correcciones puntuales y transferencia de conocimiento.

Lo que recibes

Del design system a la capacitación, todo documentado y entregado a tu equipo.

Storefront

  • Design system FastStore en React y TypeScript
  • Home, PLP, PDP, páginas institucionales y landing pages en IO
  • Intelligent Search configurado y ajustado

SEO y rendimiento

  • Metadatos, sitemap y JSON-LD
  • Matriz de redirecciones 301 de Portal a FastStore
  • Core Web Vitals en verde como meta, en desktop y móvil

Ingeniería

  • Pipeline de CI/CD y workspaces para QA
  • Documentación técnica y guía de mantenimiento

Equipo

  • Capacitación de marketing y TI
  • Plan de evolución posmigración

Riesgos típicos y cómo los mitigamos

Cinco riesgos de toda migración de storefront, con la respuesta definida antes del cutover.

Caída de rendimiento en móvilPresupuesto de rendimiento desde la fase 2, Lighthouse en cada pull request y gates de CI que bloquean el despliegue si el LCP o el CLS empeoran.
Pérdida de ranking en la cola largaAuditoría de SEO de Portal, matriz 1:1 de redirecciones, slugs, metadatos y sitemap preservados y monitoreo diario en Search Console y GA4.
Desvíos de la identidad visualDesign system revisado con el equipo de marca antes del desarrollo, revisiones quincenales en homologación y aceptación formal por pantalla antes del cutover.
Tags y personalización que se rompenInventario de tags y scripts de Portal, recreación planificada en FastStore vía GTM server-side y pruebas de extremo a extremo antes del cutover.
Equipo sin autonomía después del go-liveEnablement con capacitaciones prácticas, documentación viva y sesiones hands-on durante el hypercare.

SEO tratado como proyecto, de la planificación al post go-live

La mayor parte de las pérdidas de SEO en una migración viene de la falta de proceso, no de conocimiento. El frente de trabajo empieza en la planificación y sigue intensivo en los primeros 90 días después del go-live.

  • Auditoría de Portal: páginas con más tráfico orgánico e ingresos.
  • Matriz 1:1 de redirecciones 301 para toda URL que cambie.
  • Title, description, JSON-LD de producto, breadcrumb y canonical preservados.
  • Sitemap.xml y robots.txt validados y aceptados en Search Console.
  • Errores 404 monitoreados a diario.
  • Indexación, tráfico orgánico y ranking seguidos en Search Console y GA4.

Estimación de alto nivel

Los valores y plazos varían según la cantidad de plantillas, el volumen de personalizaciones y la madurez del design system. La estimación detallada sale al final del diagnóstico.

3 a 6 mesesPlazo típico, del diagnóstico al go-live
4 a 6 personasSquad dedicado
Según el diagnósticoInversión definida al final del diagnóstico

Las tiendas simples, con pocas páginas y un design system definido, pueden quedar entre 2 y 3 meses. Los marketplaces multitienda y multiidioma pueden llegar a 7 u 8 meses.

Migración de VTEX CMS a VTEX IO: análisis

Por qué el VTEX CMS se convirtió en un problema

El VTEX CMS Portal fue la base de decenas de miles de tiendas VTEX durante más de una década, pero el modelo de plantillas en el portal y apps heredadas envejeció. Los Core Web Vitals entraron en el ranking de Google, Intelligent Search y headless pasaron a ser la base de la innovación de VTEX y los equipos quieren trabajar con React, TypeScript, CI/CD y design system.

No se trata de migrar o no, sino de cuándo. Cuanto antes salga la tienda del sistema heredado, menor será el costo técnico acumulado y más rápido el retorno en conversión, SEO y productividad.

FastStore, el puente natural hacia el headless

FastStore es el framework open source mantenido por VTEX para storefronts headless. Basado en Next.js, ofrece SSG y SSR, imágenes optimizadas por defecto, JSON-LD listo e integración directa con las APIs de VTEX.

Para quien viene de Portal, la curva es controlada: CCX tiene un starter interno, un design system base, una biblioteca de componentes y plantillas de página que aceleran el proyecto en semanas. El resultado es un storefront propio, con las mismas herramientas que usan los grandes nativos digitales.

SEO en la migración: proceso antes y después del go-live

Muchas migraciones pierden SEO por falta de disciplina, no de conocimiento. Antes del go-live, mapeamos las URLs antiguas con tráfico orgánico relevante, las clasificamos por ingresos y armamos la matriz 1:1 de redirecciones 301. Title, description, JSON-LD de producto, breadcrumb y canonical se preservan en cada página migrada.

Una vez publicado el nuevo sitio, los primeros 90 días son de monitoreo intensivo en Search Console y Google Analytics, con auditorías externas, errores 404 seguidos a diario y sitemap.xml y robots.txt verificados. Si algún patrón de URL empieza a caer, hay un plan de reacción rápida.

Qué pasa con el checkout y las integraciones

El core de VTEX no cambia. Catálogo, pedidos, checkout, promociones, pagos y logística siguen en la misma cuenta, con las mismas apps e integraciones. La migración actúa sobre el storefront, en las capas visuales y de experiencia.

Eso reduce el riesgo operativo: no hay riesgo de perder pedidos en el cutover, las integraciones con SAP, ERP y OMS siguen intactas y el WMS y el TMS no se tocan.

Equipo, gobernanza y continuidad

Para el equipo interno, la migración es una actualización de stack. Marketing configura campañas en una interfaz más moderna, TI trabaja con React, TypeScript y CI/CD y el equipo de rendimiento gana visibilidad sobre los Core Web Vitals por entorno.

CCX entrega la base, las capacitaciones, los playbooks y un hypercare con el equipo interno operando a nuestro lado. Seis meses después del go-live, la mayoría de los clientes evoluciona el storefront con CCX como squad bajo demanda o advisory, ya no en un proyecto cerrado.

Preguntas frecuentes

¿También necesito migrar el catálogo o el checkout?

No. La migración del VTEX CMS a IO y FastStore se enfoca en el storefront. Catálogo, checkout, pagos, promociones e integraciones siguen en la misma cuenta VTEX, sin cambios.

¿Cuánto dura la migración?

Los proyectos típicos duran de 3 a 6 meses. Las tiendas simples, con pocas páginas y un design system razonablemente definido, pueden quedar entre 2 y 3 meses. Los marketplaces multitienda y multiidioma pueden llegar a 7 u 8 meses.

¿Voy a perder SEO al migrar?

Con disciplina de proceso, no. Un frente de SEO dedicado acompaña toda la migración, con matriz de redirecciones 301, slugs y metadatos preservados y monitoreo después del go-live.

¿Habrá inactividad en el cutover?

La inactividad efectiva es cercana a cero. El cambio de ruta del dominio al workspace FastStore lleva minutos, en una ventana de bajo tráfico.

¿Puedo mantener mis apps VTEX actuales?

La mayoría sigue funcionando, porque el core de la plataforma no cambia. Revisamos app por app en el diagnóstico para identificar las heredadas que deben reemplazarse.

¿Y las integraciones con ERP, OMS y WMS?

No se tocan. Se comunican con el core de VTEX, no con el storefront. Por eso el riesgo operativo de esta migración es mucho menor que el de un cambio de plataforma.

¿Cuál es el rango de inversión?

Depende de la cantidad de páginas, la complejidad del design system y el volumen de personalizaciones actuales. La estimación detallada sale al final del diagnóstico.

¿Cómo queda el mantenimiento después del go-live?

Hay tres modelos: squad dedicado bajo demanda, advisory mensual o proyectos cerrados de evolución. La mayoría de los clientes empieza con un squad reducido en los primeros seis meses y después pasa a advisory.

¿Listo para salir del VTEX CMS heredado?

Treinta minutos con un ingeniero de CCX, sin costo, para evaluar tu Portal actual y el camino hasta FastStore.