Introducción al Error de Sintaxis en Liquid
Liquid es el lenguaje de plantillas de código abierto creado por Shopify que impulsa todas las tiendas de la plataforma. Cuando se modifican los archivos del tema (como theme.liquid, index.json o secciones personalizadas), es común cometer errores tipográficos que rompen el código y provocan fallos visuales o impiden guardar los cambios. En este artículo te mostramos cómo solucionarlo de forma definitiva.
Causas Principales del Error en Liquid
Los errores de sintaxis y renderizado en Shopify suelen deberse a:
- Etiquetas de apertura o cierre mal escritas (por ejemplo,
{% if %}sin su correspondiente{% endif %}). - Uso incorrecto de filtros o variables no definidas.
- Comillas o llaves dobles mal cerradas dentro del objeto (
{{ product.title }}). - Incompatibilidad de código al actualizar o editar archivos manualmente sin respaldo previo.
Método 1: Usar el Historial de Versiones del Tema
Si realizaste un cambio reciente y la tienda dejó de funcionar correctamente, Shopify cuenta con una herramienta nativa para revertir los cambios de inmediato.
- Inicia sesión en tu panel de administración de Shopify.
- Ve a Canales de venta > Tienda online > Temas.
- En tu tema activo, haz clic en el botón de los tres puntos (...) y selecciona Editar código.
- Busca el archivo que modificaste recientemente (por ejemplo,
product-template.liquid). - En la parte superior del editor de código, haz clic en la opción Versiones anteriores.
- Selecciona una versión estable anterior al error y haz clic en Guardar.
Método 2: Validar y Corregir la Sintaxis Manualmente
Si necesitas mantener el código nuevo, debes revisar línea por línea la estructura de Liquid afectada.
- Identifica el archivo que genera el aviso de error en la consola o en la vista previa.
- Revisa que todas las estructuras de control tengan su etiqueta de cierre obligatoria. Ejemplo correcto:
Disponible{% if product.available %}
- Asegúrate de que los objetos estén delimitados correctamente por dos llaves y las etiquetas lógicas por llaves y porcentajes.
- Haz clic en Guardar y verifica que el sistema no arroje advertencias en rojo.