Skip to main content

Liquid o JavaScript: cómo decidir la arquitectura de un tema de Shopify

Si una ficha de producto necesita JavaScript para mostrar información que Shopify ya tiene, la tienda añade una dependencia al recorrido de compra. La regla práctica: Liquid renderiza lo que existe al responder, JavaScript solo para lo que cambia con la interacción.

, Fundador y CEO de Shugert · · Actualizado · 5 min de lectura

Responsabilidades de Liquid (HTML en servidor, datos de producto, SEO) frente a JavaScript (interacción) en un tema Shopify

Cuando una ficha de producto depende de JavaScript para mostrar información que Shopify ya tiene disponible al generar la página, la tienda añade una dependencia innecesaria al recorrido de compra. Esa dependencia complica el diagnóstico, retrasa el contenido principal en teléfonos lentos y puede ocultar información a los buscadores si algo falla.

La decisión no es "Liquid o JavaScript" en abstracto. Es asignar cada responsabilidad a la capa correcta.

Respuesta corta

Usa Liquid para todo lo que Shopify conoce al responder: título, precio inicial, disponibilidad, imágenes, especificaciones, enlaces y marcado. Usa JavaScript para lo que cambia con la interacción: cambio de variante, carrito, filtros sin recarga. Cuando JavaScript necesita HTML nuevo del servidor, usa la Section Rendering API para pedir la sección ya renderizada por Liquid en lugar de reconstruirla en el navegador.

Por qué importa el HTML inicial

Liquid se ejecuta en los servidores de Shopify y entrega HTML completo. Lo que viene en ese HTML:

  • Aparece sin esperar a que se descargue y ejecute JavaScript.
  • Es lo primero que ven los rastreadores, antes de cualquier renderizado.
  • Sigue funcionando si un script de terceros falla.
  • Se puede almacenar en la caché de la CDN de Shopify.

Lo que depende de JavaScript para aparecer compite con apps, píxeles y el resto del trabajo del hilo principal. Si el precio o la disponibilidad llegan por una petición después de cargar, el comprador espera y el elemento LCP puede retrasarse (LCP en temas de Shopify).

Matriz de decisión

NecesidadPunto de partidaCómo comprobarlo
Información inicial del productoLiquidDesactiva JavaScript: ¿se entiende y se puede comprar?
Cambio de varianteJavaScript acotado + datos de la variante en la páginaPrecio, disponibilidad e imagen correctos
Contenido de sección que cambiaSection Rendering APILa respuesta es HTML de Liquid, no plantillas duplicadas en JS
Datos externos que cambian (envío estimado, stock en sucursal)Petición asíncrona con fallbackTiempo de espera y error visibles
Personalización por clienteLiquid con customer o petición autenticadaNo exponer datos de otros clientes

Section Rendering API: el punto medio que muchos temas ignoran

El error clásico es duplicar la lógica de presentación: Liquid renderiza la ficha, y luego JavaScript tiene su propia plantilla para volver a dibujarla al cambiar de variante. Cada cambio de diseño se hace dos veces y tarde o temprano las dos versiones divergen.

La Section Rendering API permite pedir el HTML de una sección ya renderizada por Liquid para una URL específica:

js
async function renderVariant(variantId) {
  const url = `${location.pathname}?variant=${variantId}&section_id=main-product`;
  const html = await fetch(url).then((r) => r.text());
  const doc = new DOMParser().parseFromString(html, "text/html");
  // Reemplaza solo lo que cambió, no la sección completa.
  for (const id of ["price", "inventory", "buy-buttons"]) {
    document.getElementById(id)?.replaceWith(doc.getElementById(id));
  }
}

Una sola fuente de verdad (Liquid), una actualización mínima del DOM (mejor para INP) y nada de plantillas paralelas en JavaScript. Para cambios instantáneos de precio e imagen, combina esto con los datos de variantes que ya entrega la página.

Antipatrones que encontramos en auditorías

  • Ficha que se monta en el navegador. El HTML trae un contenedor vacío y una app o framework dibuja todo. El buscador ve una página vacía si el renderizado falla y el cliente ve un esqueleto de carga.
  • Precio desde una petición. El precio inicial llega por fetch aunque Liquid ya lo conocía.
  • Bibliotecas completas para una interacción. Un carrusel o selector que trae una librería de 100 KB para algo que el navegador ya resuelve.
  • Re-render total en cada cambio. Reemplazar el bloque de producto completo para cambiar un precio. Detalle en INP en Shopify.

Prueba con catálogo real

Prueba una ficha con muchas variantes, una agotada y otra con app de suscripciones o preventa. Una ficha sencilla no representa a toda la tienda. Haz los cambios en una copia del tema (por qué duplicar el tema antes de cambiar), registra el comportamiento previo y verifica precios, variantes, carrito, medición y accesibilidad antes de publicar.

Preguntas frecuentes

¿Liquid es mejor que JavaScript para el SEO en Shopify?

Para el contenido principal, sí: lo que Liquid renderiza llega en el HTML inicial y no depende de que el buscador ejecute scripts. JavaScript es adecuado para interacciones, siempre que la información esencial ya esté en el HTML.

¿Qué es la Section Rendering API de Shopify?

Es una forma de pedir el HTML de una o varias secciones del tema, renderizadas por Liquid, para una URL concreta. Permite actualizar partes de la página con JavaScript sin duplicar la lógica de presentación.

¿Cuándo tiene sentido un frontend headless en lugar de Liquid?

Cuando la experiencia requiere algo que un tema no puede ofrecer razonablemente o el negocio necesita un frontend compartido con otros canales. Implica más costo de desarrollo y mantenimiento; para la mayoría de las tiendas DTC, un tema Liquid bien construido es más rápido y barato de operar.

¿Cómo sé si mi tema depende demasiado de JavaScript?

Desactiva JavaScript y carga una ficha de producto. Si no ves título, precio, imágenes y especificaciones, el tema depende de JavaScript para contenido que debería venir del servidor.

Siguiente paso

La documentación de arquitectura de temas describe las piezas disponibles. Para el contexto de temas, apps e integraciones, revisa la guía de desarrollo Shopify.

Sigue leyendo