Introducción al Error de Sintaxis en Liquid
El motor de plantillas Liquid es el corazón visual de Shopify. Permite mostrar dinámicamente los productos, precios y colecciones. Sin embargo, un simple error de tipeo, una etiqueta sin cerrar o un filtro mal aplicado puede romper por completo el diseño de tu tienda online, mostrando un mensaje de error crítico en lugar de tu escaparate.
Causas Comunes del Error de Liquid
Los fallos en el código Liquid suelen aparecer tras realizar modificaciones manuales en los archivos del tema. Las causas más frecuentes son:
- Etiquetas de apertura o cierre incompletas (por ejemplo, olvidar
{% endif %}o{% endfor %}). - Uso de variables no definidas o mal escritas dentro del objeto.
- Filtros de Liquid aplicados incorrectamente a tipos de datos incompatibles.
Método 1: Identificar el error mediante la consola de Shopify
Cuando ocurre un fallo de Liquid, Shopify suele indicar el archivo exacto donde se originó el problema.
- Inicia sesión en tu panel de administración de Shopify.
- Ve a Canales de venta > Tienda online > Temas.
- Haz clic en los tres puntos del tema actual y selecciona Editar código.
- Revisa la barra de notificaciones inferior o busca marcas rojas en los archivos recientes modificados (como
index.liquidoproduct-template.liquid).
Método 2: Corregir etiquetas de control no cerradas
El error más común es olvidar cerrar una estructura condicional o un bucle.
- Localiza el archivo defectuoso indicado por Shopify.
- Busca bloques de código que utilicen
{% if %},{% paginate %}o{% for %}. - Asegúrate de que cada instrucción de apertura tenga su respectiva etiqueta de cierre. Ejemplo correcto:
{% if product.available %} <p>Disponible</p>{% endif %}
Método 3: Restaurar una versión anterior del archivo
Si no logras encontrar el error exacto en el código, Shopify guarda un historial de cambios que te permite volver a una versión estable.
- Dentro del editor de código, abre el archivo que está causando el problema.
- Haz clic en el enlace Versiones anteriores ubicado en la parte superior central del editor.
- Selecciona una fecha y hora anterior a cuando realizaste los cambios defectuosos.
- Haz clic en Guardar para aplicar la versión limpia y verificar que tu tienda vuelva a funcionar con normalidad.