Introducción al Error de Sintaxis Liquid en Shopify
El lenguaje de plantillas Liquid es el núcleo del diseño y la personalización en Shopify. Sin embargo, un pequeño error tipográfico al editar el código de tu tema puede romper la visualización de tu tienda online, mostrando mensajes como Liquid syntax error o bloqueando directamente la carga de la página. Afortunadamente, estos fallos son fáciles de detectar y corregir si sabes dónde buscar.
Causas Principales del Error de Liquid
Los errores de sintaxis en Liquid suelen ocurrir por:
- Falta de etiquetas de cierre en objetos o etiquetas de control (por ejemplo, olvidar un
{% endif %}o{% endfor %}). - Uso incorrecto de operadores o filtros dentro de las llaves
{{ }}o{% %}. - Variables mal escritas o llamadas a objetos que no existen en el contexto actual de la página.
- Uso de caracteres especiales no escapados dentro del código HTML/Liquid.
Método 1: Identificar el error desde el editor de código de Shopify
Shopify cuenta con un sistema de alertas integrado que te avisa exactamente dónde se encuentra el fallo en tus archivos.
- Inicia sesión en tu panel de administración de Shopify y ve a Canales de venta > 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 editaste recientemente (por ejemplo,
index.liquidoproduct-template.liquid). - Observa la línea marcada con un icono rojo de advertencia o un número de línea señalado por Shopify.
- Revisa el código en busca de etiquetas abiertas sin cerrar, como
{% if product.available %}que carezca de su respectivo{% endif %}. - Haz clic en Guardar una vez corregido el error para verificar que el aviso desaparezca.
Método 2: Revertir a una versión anterior del archivo
Si realizaste múltiples cambios y no logras dar con la línea exacta del error de sintaxis, Shopify guarda un historial de versiones recientes que te permite volver atrás en pocos clics.
- Dentro del Editor de código de tu tema, abre el archivo que está generando el problema.
- Busca en la parte superior del editor de código el enlace que dice Versiones más recientes (Older versions).
- Haz clic en el menú desplegable y selecciona una fecha y hora anterior a cuando realizaste las modificaciones defectuosas.
- El código del archivo cambiará al estado en el que se encontraba en ese momento.
- Haz clic en Guardar y recarga tu tienda en una pestaña de incógnito para comprobar que el error de Liquid se ha solucionado por completo.