Introducción al Error de Sintaxis en Liquid
El motor de plantillas Liquid es el corazón visual y funcional de Shopify. Cuando modificas el código de tu tema (en archivos como index.liquid, product-template.liquid o theme.liquid) y cometes un pequeño error tipográfico, Shopify te devuelve un molesto mensaje de error de sintaxis que impide guardar los cambios o rompe la visualización de la tienda.
Causas Principales del Error de Sintaxis
Los fallos en Liquid suelen ocurrir por razones muy específicas durante la edición manual del código:
- Falta de etiquetas de cierre, como olvidar cerrar un
{% if %}con un{% endif %}. - Uso incorrecto de delimitadores, confundiendo
{{ }}(para variables) con{% %}(para etiquetas de lógica). - Errores tipográficos en los nombres de los filtros o variables predeterminadas de Shopify.
- Comillas o apóstrofes mal anidados dentro de las cadenas de texto.
Método 1: Revisar el Historial de Cambios de Shopify
Si estabas editando una plantilla y de repente apareció el error, la forma más rápida de solucionarlo es revertir al último estado funcional gracias al control de versiones nativo de Shopify.
- Entra a 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 exacto donde realizaste la última modificación.
- En la parte superior del editor de código, haz clic en el menú desplegable Versiones anteriores.
- Selecciona la versión guardada inmediatamente anterior a tu modificación y haz clic en Guardar.
Método 2: Validar Etiquetas de Apertura y Cierre
La causa número uno de los errores de sintaxis es un bloque condicional o un bucle incompleto. Debes revisar minuciosamente las etiquetas de control.
- Localiza la línea exacta que señala el mensaje de error de Shopify (por ejemplo:
Liquid syntax error: Expected end_of_string was tag). - Busca etiquetas condicionales abiertas como
{% if product.available %}y asegúrate de que tengan su correspondiente{% endif %}. - Verifica que los bucles
{% for item in collection.products %}terminen siempre con{% endfor %}. - Comprueba que no existan espacios extraños dentro de los delimitadores, por ejemplo, usando
{ % if % }en lugar de{% if %}.
Método 3: Aislar el Código con Comentarios Liquid
Si no logras encontrar el error visualmente, puedes usar bloques de comentarios para aislar fragmentos de código hasta dar con el culpable.
- Envuelve temporalmente el bloque de código sospechoso con las etiquetas de comentario de Liquid:
{% comment %} ...tu código... {% endcomment %}. - Haz clic en Guardar. Si el error desaparece, ya sabes que el problema está dentro de esas líneas.
- Descomenta línea por línea o sección por sección hasta identificar el carácter exacto que está rompiendo la sintaxis.