Introducción al Error de Sintaxis Liquid en Shopify
El motor de plantillas Liquid es el corazón visual y funcional de Shopify. Sin embargo, un simple error tipográfico al editar el código de tu tema puede romper la renderización de tu tienda online, mostrando mensajes de error críticos en la interfaz o impidiendo que la página cargue correctamente.
Causas Comunes de los Errores Liquid
- Etiquetas de apertura o cierre mal escritas, como
{% if %}sin su correspondiente{% endif %}. - Uso incorrecto de filtros Liquid o sintaxis de variables obsoletas.
- Comillas o llaves dobles mal anidadas (
{{en lugar de{%).
Método 1: Identificar el archivo y la línea exacta del error
- Inicia sesión en tu panel de administración de Shopify y ve a Tienda online > Temas.
- Haz clic en los tres puntos del tema actual y selecciona Editar código.
- Revisa el archivo modificado recientemente. Shopify suele mostrar una advertencia visual o un mensaje de error directo indicando el número de línea exacto donde falló la compilación de Liquid.
Método 2: Revertir los cambios usando el historial de código
- Dentro del editor de código de tu tema, navega hasta el archivo que generó el problema.
- Haz clic en el botón Historial situado en la parte superior del editor de archivos.
- Selecciona una versión anterior previa a la modificación que causó el fallo.
- Haz clic en Guardar para restaurar la versión estable y comprobar que la tienda vuelve a funcionar con normalidad.
Método 3: Corregir manualmente la sintaxis con bloques de prueba
- Aísla el fragmento de código problemático comentándolo mediante las etiquetas de comentario de Liquid:
{% comment %} ... {% endcomment %}. - Recarga tu tienda para verificar si el error desaparece.
- Vuelve a habilitar el código por partes, asegurándote de cerrar correctamente todas las condiciones y bucles, por ejemplo:
{% for product in collection.products %}{{ product.title }}{% endfor %}.