Introducción al Error de Sintaxis Liquid en Shopify
El motor de plantillas Liquid es el corazón visual de Shopify. Cuando modificas el código de tu tema (en archivos .liquid, .json o secciones), es muy común cometer errores tipográficos que rompen la renderización de la página. Esto suele manifestarse con un mensaje de error rojo directamente en el editor de código o con una pantalla rota en la tienda.
Causas Principales del Error
- Etiquetas de apertura o cierre incompletas (por ejemplo, olvidar cerrar un
{% if %}con un{% endif %}). - Uso de variables mal escritas o no definidas en el contexto actual del objeto.
- Filtros Liquid mal aplicados o con nombres incorrectos.
- Errores de sintaxis JSON en archivos de configuración o esquemas.
Método 1: Revisar el Historial de Ediciones y Revertir Cambios
Si el error apareció inmediatamente después de modificar un archivo, la forma más rápida de solucionarlo es volver a una versión anterior:
- Inicia sesión en tu panel de administración de Shopify.
- Ve a Tienda online > Temas.
- Haz clic en el botón de los tres puntos (...) junto al tema activo y selecciona Editar código.
- Busca el archivo que modificaste recientemente.
- En la parte superior del editor de código, haz clic en la opción Historial de versiones.
- Selecciona la versión anterior que funcionaba correctamente y haz clic en Guardar.
Método 2: Validar y Corregir la Sintaxis del Código Liquid
Si necesitas mantener los cambios recientes, debes revisar manualmente el código en busca de etiquetas huérfanas:
- Identifica la línea exacta que señala el editor de Shopify en la parte inferior o lateral.
- Asegúrate de que cada etiqueta de control tenga su correspondiente cierre. Por ejemplo:
{% for product in collection.products %} ... {% endfor %}. - Verifica que los delimitadores estén correctos: usa
{{ }}para imprimir variables y{% %}para la lógica de programación. - Comprueba que las comillas en los atributos estén cerradas correctamente.
Método 3: Duplicar el Tema para Pruebas Seguras
Para evitar afectar a tus clientes mientras solucionas el problema:
- Ve a Tienda online > Temas.
- Haz clic en los tres puntos del tema actual y selecciona Duplicar.
- Realiza las depuraciones necesarias en la copia duplicada (Tema secundario) sin miedo a romper la tienda en producción.
- Una vez solucionado el error, publica el tema duplicado.