¿Qué es un error de sintaxis en Liquid y por qué ocurre en Shopify?
El lenguaje de plantillas Liquid es la base sobre la cual se construyen los temas de Shopify. Cuando modificas el código de tu tienda (archivos .liquid) y cometes un error tipográfico, de etiquetado o usas una variable no definida, Shopify bloquea la renderización de la página y muestra un mensaje de error de sintaxis en el editor.
Causas principales del error en plantillas Liquid
- Etiquetas de apertura sin su correspondiente cierre (por ejemplo,
{% if %}sin{% endif %}). - Uso de filtros o variables mal escritas o incompatibles.
- Caracteres especiales o comillas mal cerradas dentro de los objetos Liquid.
- Modificación directa en producción sin realizar pruebas previas en un tema duplicado.
Método 1: Revisar el registro de cambios y la línea exacta del error
Shopify suele indicar el archivo exacto y el número de línea donde se ha producido el fallo de sintaxis.
- Entra a tu panel de administración de Shopify y ve a Canales de venta > Tienda online > Temas.
- Haz clic en los tres puntos del tema activo y selecciona Editar código.
- Busca el archivo mencionado en el aviso de error (por ejemplo,
index.liquidoproduct-template.liquid). - Dirígete al número de línea indicado por el sistema y busca discrepancias en las etiquetas como
{{ }}o{% %}.
Método 2: Validar etiquetas de control y filtros
Los errores más comunes provienen de bucles y condicionales mal cerrados. Sigue estos pasos para corregirlos:
- Localiza la estructura condicional en el código, por ejemplo:
{% if product.available %} ... {% endif %}. - Asegúrate de que cada
{% if %},{% unless %}o{% paginate %}tenga su respectivo{% endif %},{% endunless %}o{% endpaginate %}. - Verifica que los filtros estén separados correctamente por una barra vertical
|y no por otros símbolos. Ejemplo correcto:{{ product.title | escape }}. - Haz clic en Guardar y recarga tu tienda para verificar que el error haya desaparecido.