Introducción al error de sintaxis Liquid en Shopify
El motor de plantillas Liquid es el corazón visual de Shopify. Cuando modificas el código de tu tienda para personalizar el diseño, es muy común cometer pequeños errores tipográficos que rompen la renderización de la página. Si aparece un mensaje indicando un fallo de sintaxis, tu tienda o secciones específicas dejarán de mostrarse correctamente a los clientes.
Principales causas del error de sintaxis en Liquid
Los problemas en las plantillas suelen derivarse de errores humanos al editar archivos HTML o JSON combinados con etiquetas de Liquid. Las causas más frecuentes incluyen:
- Etiquetas de apertura o cierre incompletas (por ejemplo, olvidar
{% endif %}o{% endfor %}). - Uso incorrecto de filtros o variables mal escritas.
- Comillas o llaves dobles mal cerradas
{{ variable }en lugar de{{ variable }}. - Modificaciones directas en archivos JSON de secciones con comas faltantes.
Método 1: Revertir los cambios usando el historial de versiones del tema
Shopify guarda automáticamente un registro de las modificaciones recientes en tu tema, lo que permite volver a una versión estable en pocos clics.
- Inicia sesión en tu panel de administración de Shopify y ve a Tienda online > Temas.
- Haz clic en el botón de los tres puntos
...al lado del tema activo y selecciona Editar código. - Busca el archivo que editaste recientemente (por ejemplo,
index.liquidoproduct-template.liquid). - Haz clic en la opción Versiones anteriores situada justo arriba del editor de código.
- Selecciona la versión previa al momento en que apareció el error y haz clic en Guardar.
Método 2: Identificar y corregir manualmente la línea afectada
Si no puedes perder los cambios recientes, debes encontrar el error exacto señalando la línea que indica la advertencia de Shopify.
- Abre el archivo problemático en el editor de código de Shopify.
- Revisa la consola de errores o el mensaje de notificación que suele especificar el número de línea aproximado del fallo.
- Verifica que todas las etiquetas lógicas tengan su correspondiente cierre. Ejemplo correcto:
{% if product.available %}Disponible
{% endif %} - Asegúrate de que los objetos utilicen las llaves dobles correctas:
{{ product.title }}. - Haz clic en Guardar y comprueba la vista previa de tu tienda para confirmar que el error ha desaparecido.