Introducción al Error de Sintaxis Liquid en Shopify
El motor de plantillas Liquid es el corazón visual de Shopify. Permite mostrar datos dinámicos en tu tienda online, pero un simple error tipográfico en las llaves o etiquetas puede romper por completo el diseño de tu sitio web, mostrando mensajes de error como Liquid syntax error o bloqueando la carga de la página de producto.
Causas Principales del Fallo en las Plantillas
Los errores de Liquid suelen aparecer tras realizar modificaciones manuales en el código fuente del tema. Las causas más comunes incluyen:
- Falta de cierre en las etiquetas de apertura (por ejemplo, olvidar cerrar un
{% if %}con un{% endif %}). - Uso incorrecto de los delimitadores
{{ }}para variables y{% %}para lógica. - Incompatibilidad de variables o filtros aplicados a objetos nulos o vacíos.
Método 1: Revisar el Historial de Versiones del Tema
Si el error apareció recientemente, la forma más rápida de solucionarlo es revertir los cambios en el editor de código.
- Inicia sesión en tu panel de administración de Shopify y ve a Canales de venta > Tienda online > Temas.
- Haz clic en los tres puntos (...) junto al tema activo y selecciona Editar código.
- Si sabes qué archivo modificaste (por ejemplo,
product-template.liquidoindex.liquid), ábrelo. - Busca la opción Historial en la parte superior del editor de código.
- Selecciona una versión anterior funcional antes de que apareciera el error de sintaxis y haz clic en Guardar.
Método 2: Identificar y Corregir la Línea del Error Manualmente
Shopify suele indicar el archivo y el número de línea aproximado donde se ha producido el fallo de sintaxis.
- Lee detenidamente el mensaje de error que aparece en la pantalla de vista previa de tu tienda o en el editor.
- Navega hasta el archivo exacto mencionado en la advertencia.
- Inspecciona la línea señalada y busca errores comunes como etiquetas incompletas, por ejemplo:
{% assign total = price * 2(falta el cierre con%}). - Corrige la sintaxis asegurándote de que todas las estructuras condicionales y bucles estén cerrados correctamente:
Disponible{%- if product.available -%}
- Haz clic en el botón Guardar y verifica que la tienda vuelva a cargar con normalidad.