Artículos

E-commerce 9 min de lectura

Shopify headless con Hydrogen: cuándo conviene y cuándo es un error

Qué es Shopify headless, cómo se construye hoy con Hydrogen y la Storefront API, cuándo conviene, cuándo es un error y qué punto medio suele bastar.

André Valle Ortega Fundador, Flouvia

Ir a Shopify headless significa separar el frente de tu tienda del motor que la opera: Shopify sigue a cargo del catálogo, el carrito, el checkout y los pagos, y tu equipo construye todo lo que ve el cliente. El 14 de octubre de 2026 salió Hydrogen 2026-10 y cambió la forma de hacerlo. Esta guía es para quien tiene que decidir si vale la pena.

¿Qué es Shopify headless?

En una tienda Shopify tradicional, el tema muestra la tienda y habla con el motor de comercio. Headless separa esos dos trabajos. La documentación de Shopify lo resume así: el comercio headless (headless commerce) separa el frente de tu tienda de su backend. Tú construyes el frente con el framework y el hosting que elijas, y las APIs de Shopify resuelven el comercio por debajo.

  • Lo que se queda en Shopify: productos, inventario, precios por mercado, carrito, checkout, pagos, pedidos y cuentas de cliente, administrados desde el mismo admin.
  • Lo que pasa a ser tuyo: cada página, la navegación, el buscador, la interfaz del carrito, las páginas de cuenta, el contenido, las etiquetas para buscadores y el servidor donde corre todo.

Como el frente y el motor viven separados, puedes conectar un CMS, tu CRM o tu ERP a cualquiera de los dos lados. El precio es que el frente deja de ser un tema que Shopify aloja por ti y se vuelve software que tu empresa opera.

Cómo se construye hoy: Hydrogen, Oxygen y las APIs de Shopify

Un frente headless sobre Shopify tiene cuatro piezas, y son las que vas a leer en cualquier propuesta.

Dos lados, unidos por las APIs de Shopify

Tu frente Lo construye y lo opera tu equipo
  • Páginas y navegación
  • Buscador
  • Interfaz del carrito
  • Páginas de cuenta
  • Contenido y etiquetas para buscadores
  • Hydrogen, dentro de tu framework
  • En Oxygen, Vercel u otro hosting
  • Storefront API Catálogo, búsqueda y carrito, según el mercado
  • Customer Account API Sesión, pedidos, direcciones y perfil
Shopify El motor, desde el mismo admin
  • Productos e inventario
  • Precios por mercado
  • Carrito
  • Pedidos
  • Cuentas de cliente

Al pagar, el carrito lleva al checkout

Checkout de Shopify Con tus extensiones y Functions
Lo que construye tu equipo y lo que se queda en Shopify. Las APIs unen los dos lados y el checkout sigue siendo de Shopify.

Storefront API y Customer Account API

La Storefront API entrega productos, colecciones, búsqueda y carrito, y lleva al cliente al checkout; con la directiva @inContext devuelve precios, idioma y disponibilidad según el mercado de cada visitante. Para compradores reales no tiene un límite fijo de peticiones por minuto: lo que se limita es el tráfico automatizado. La Customer Account API permite que tus clientes inicien sesión en una página que aloja Shopify y les sirve sus pedidos, direcciones y perfil.

Shopify Hydrogen, ahora una biblioteca y no un framework

Hasta la versión 2026-04, Hydrogen era un framework completo sobre Remix o React Router: para usar su carrito, construías toda la tienda dentro de él. Desde la 2026-10 es un kit que agregas al framework que ya usas. Shopify ofrece dos plantillas de arranque: una en React Router 7, que se despliega en Oxygen, y Vercel Shop, en Next.js, que mantiene Vercel. Para Nuxt, Astro, SvelteKit y SolidStart, documenta cómo conectarlo.

Hydrogen resuelve lo que es propio de Shopify y fácil de hacer mal: carrito, variantes, filtros de colección, búsqueda predictiva, Markets, analítica con consentimiento, Shop Pay y cuentas de cliente. También restaura rutas que necesita una tienda, como los permalinks de carrito, el paso al checkout y las redirecciones del admin. No trae componentes: el diseño, las rutas y las etiquetas para buscadores las construye tu equipo.

Oxygen

Oxygen es el hosting de Shopify para tiendas Hydrogen, con entornos, despliegues desde GitHub con vista previa y variables en el admin, sin cargo extra en los planes de pago. No es obligatorio: con el canal Headless puedes alojar el frente en Vercel o en otro proveedor.

El checkout sigue siendo de Shopify

Headless no significa construir tu propio checkout. El carrito lleva al cliente al checkout de Shopify, donde siguen corriendo tus extensiones de checkout y tus Shopify Functions. Lo tuyo es todo lo que pasa antes de pagar.

Cuándo sí conviene ir a headless

Shopify lo plantea así: considera headless cuando la experiencia, los sistemas o los procesos de tu negocio no caben en sus canales, sus temas y sus apps. En la práctica, eso pasa en cuatro situaciones:

  • Varias vitrinas sobre un mismo catálogo. Un sitio de marca, una app móvil o un sitio por marca que comparten productos, inventario y pedidos. Vender en varios países no basta, porque Markets ya funciona en un tema; conviene cuando cada mercado o marca necesita un frente distinto, no solo otra moneda.
  • Contenido editorial complejo. Guías, lookbooks o catálogos técnicos que viven en un CMS y se mezclan con producto, con un equipo que publica cada semana.
  • Una experiencia que un tema no resuelve bien. Configuradores, armado de kits o búsqueda con lógica propia, donde forzar Liquid cuesta más que construir el frente.
  • Otros sistemas en el frente. Disponibilidad que viene de tu ERP, precios o contenido de otra plataforma, o un sitio que ya tienes en Next.js o Astro y al que quieres sumar comercio.

La quinta condición no es técnica: un equipo de desarrollo, propio o externo, comprometido con el frente después del lanzamiento. Shopify lo dice sin rodeos: construir y operar un frente headless cuesta más que un tema.

Cuándo headless es un error

Headless suele venderse como una mejora de diseño o de velocidad. Muchas veces ataca un problema que la tienda no tiene. Es un error cuando:

  • Nadie va a mantener el frente. Shopify publica una versión de sus APIs cada trimestre, con soporte de al menos 12 meses, y cada versión de Hydrogen va atada a una de la Storefront API. Con dependencias, hosting y monitoreo encima, el frente pide trabajo constante, no un proyecto que se entrega y se cierra.
  • Tu tienda depende de apps que solo viven en el tema. Muchas apps de la App Store se integran con bloques de app, archivos Liquid para temas de Online Store 2.0 que no aparecen en un frente propio. Hydrogen 2026-10 restaura las rutas del carrito y el contrato estándar de eventos y acciones que usan las apps compatibles, pero reseñas, lealtad o cualquier widget visual se integran por la API del proveedor, si la tiene, o se reconstruyen. Haz la lista antes de decidir.
  • Tu equipo de marketing vive en el editor de temas. En headless no existe. Lo que hoy alguien mueve sin ayuda pasa a un CMS o a metaobjetos que alguien tiene que modelar.
  • El presupuesto alcanza para construir, no para operar. Cada cambio de diseño, cada campaña y cada app nueva pasan por desarrollo.
  • El problema real es de conversión. Si tu tienda vende poco, rara vez es por la arquitectura: la fricción en el checkout, una experiencia móvil descuidada o las fichas genéricas se corrigen en el tema que ya tienes. Empieza por los cinco errores de CRO más comunes en Shopify.
Ir a headless no es rediseñar tu tienda: es decidir que tu empresa va a operar un producto de software propio.

Tema contra headless: qué ganas y qué pierdes

La comparación honesta no es entre algo viejo y algo nuevo. Son dos maneras de repartir el trabajo entre Shopify y tu equipo:

CriterioTema de Online Store 2.0Headless con Hydrogen
Velocidad de salidaPartes de un tema y de secciones resueltas; lanzas antesConstruyes cada página, el carrito y las cuentas; las plantillas acortan el arranque, pero el diseño es tuyo
Control de la experienciaAmplio, dentro de Liquid, secciones y bloquesTotal en el frente: rutas, render, interacción y contenido
Compatibilidad con appsLas apps de la App Store se agregan como bloques desde el editorLas que trabajan con el carrito pueden seguir funcionando; los widgets visuales se integran por API o se reconstruyen
Edición del contenidoEditor de temas, sin pasar por desarrolloUn CMS o metaobjetos que alguien modela; no hay editor de temas
Costo de mantenimientoShopify aloja y sirve el tema; tú mantienes su código y sus appsSoftware propio: versiones trimestrales de la API, dependencias, hosting y monitoreo
SEOShopify genera el sitemap y el robots.txt, y con Markets agrega las etiquetas hreflangPuede indexarse igual de bien, pero etiquetas, datos estructurados, sitemap y hreflang los construye tu equipo; Hydrogen respeta las redirecciones del admin
CheckoutEl de Shopify, con extensiones y FunctionsEl mismo: el de Shopify, con extensiones y Functions

Sobre la velocidad de carga: un frente headless no es más rápido por definición. Si ese es tu argumento principal, mide primero el tema que ya tienes.

El punto medio: un tema bien hecho y un checkout extendido

Entre el tema que compraste y un frente propio hay un punto medio que resuelve buena parte de los casos que llegan pidiendo headless:

  • Un tema de Online Store 2.0 a la medida. Secciones y bloques diseñados para tu marca, contenido que sale de metacampos y metaobjetos, y código propio donde hoy cargas una app para algo sencillo. Tu equipo sigue editando sin depender de desarrollo.
  • Un checkout extendido. Las extensiones de checkout agregan campos, mensajes u ofertas: en Shopify Plus, también en los pasos de información, envío y pago; en todos los planes salvo Starter, en las páginas de agradecimiento y de estado del pedido. Las Shopify Functions cambian la lógica de descuentos, envíos, pagos y validaciones.
  • Piezas headless solo donde hacen falta. Storefront Web Components o Buy Button JS agregan productos y botones de compra a un sitio editorial que ya tienes, y Hydrogen 2026-10 se suma a un proyecto existente sin que tu tienda deje de ser un tema.

Tres maneras de repartir el trabajo

Shopify opera más

  1. Tema de Online Store 2.0

    Shopify aloja y sirve el tema

    • Secciones y bloques en el editor de temas
    • Apps de la App Store como bloques
    • Tú mantienes su código y sus apps
  2. El punto medio

    Un tema a la medida y un checkout extendido

    • Secciones de tu marca, con metacampos y metaobjetos
    • Campos, mensajes y ofertas en el checkout
    • Piezas headless solo donde hacen falta
  3. Headless con Hydrogen

    Un frente propio que tu empresa opera

    • Rutas, render, contenido y SEO
    • Un CMS o metaobjetos, sin editor de temas
    • Versiones trimestrales, hosting y monitoreo

Tu equipo opera más

En los tres, el checkout es el de Shopify, con extensiones y Functions

Entre el tema y un frente propio, el punto medio reparte el trabajo sin perder el editor de temas. El checkout es el mismo en los tres.

Antes de decidir, responde por escrito:

  1. ¿Qué experiencia concreta no puedes construir con tu tema y tus extensiones?
  2. ¿Quién va a mantener el frente después del lanzamiento, y con qué presupuesto al mes?
  3. ¿Qué apps dejarían de verse y cómo vas a reemplazar cada una?
  4. ¿Quién va a editar el contenido, y en qué herramienta?
  5. ¿Contra qué línea base vas a medir si el cambio funcionó?

Si las respuestas apuntan a headless, el proyecto tiene fundamento; si no, un tema bien construido te lleva más lejos con menos. En Flouvia diseñamos y construimos tiendas Shopify Plus, con tema a la medida o headless, según lo que pida tu operación. Si lo estás evaluando, cuéntanos qué necesitas.

Preguntas frecuentes

  • ¿Necesito Shopify Plus para tener una tienda headless?
    No. Oxygen está disponible sin cargo extra en los planes de pago de Shopify, no solo en Plus. Plus suma lo que pasa alrededor: extender los pasos de información, envío y pago del checkout, usar apps propias con Shopify Functions y tener hasta 25 entornos públicos en Oxygen, contra uno en los demás planes de pago.
  • ¿Hydrogen sigue construido sobre Remix o React Router?
    Ya no. Hasta la versión 2026-04 lo era; desde la 2026-10 es una biblioteca que agregas a tu framework, con plantillas de arranque en React Router 7 y Next.js. Las tiendas anteriores siguen funcionando, y Shopify publica una guía para migrarlas.
  • ¿Pierdo el checkout de Shopify si voy a headless?
    No. Tu frente lleva al cliente al checkout de Shopify, con las mismas extensiones de checkout y Shopify Functions.
  • ¿Headless mejora el SEO?
    No por sí solo. Un frente que se renderiza en el servidor puede indexarse igual de bien que un tema, pero tu equipo construye lo que el tema ya trae. Si migras, mapea cada URL antes de lanzar, aunque Hydrogen respete las redirecciones del admin.
  • ¿Puedo usar Next.js en lugar de Hydrogen?
    No tienes que elegir: Hydrogen 2026-10 funciona dentro de Next.js, y Vercel Shop es la plantilla para empezar. También puedes llamar directo a la Storefront API y a la Customer Account API desde cualquier stack, con las credenciales del canal Headless.

Escrito por

André Valle Ortega

Fundador, Flouvia

André Valle Ortega es fundador de Flouvia, el estudio de diseño e ingeniería que construye a la medida sitios web, tiendas, portales, apps, plataformas y automatizaciones.

LinkedIn