¿Qué es el Error de Sintaxis Liquid en Shopify?
El lenguaje de plantillas Liquid es el núcleo del diseño visual en Shopify. Cuando se editan archivos de temas como theme.liquid, index.json o secciones personalizadas, es muy común cometer pequeños errores tipográficos que rompen la renderización de la tienda online, mostrando advertencias como 'Liquid syntax error'.
Causas Principales del Fallo en las Plantillas
Los errores de Liquid suelen ser causados por:
- Etiquetas de apertura o cierre incompletas (por ejemplo, olvidar cerrar un
{% if %}con un{% endif %}). - Uso incorrecto de filtros o variables no definidas.
- Comillas o llaves dobles mal colocadas en el código HTML/Liquid.
Método 1: Revisar el Historial de Cambios del Tema
Shopify guarda automáticamente copias de seguridad de las modificaciones recientes en tus archivos.
- Inicia sesión en tu panel de administración de Shopify.
- Ve a Canales de venta > Tienda online > Temas.
- Haz clic en los tres puntos junto a tu tema actual y selecciona Editar código.
- Busca el archivo que generó el error y haz clic en Versiones anteriores en la parte superior del editor.
- Selecciona una versión anterior en la que la tienda funcionaba correctamente y haz clic en Guardar.
Método 2: Validar y Corregir la Sintaxis Manualmente
Si necesitas mantener el código nuevo, debes rastrear la línea exacta que indica el mensaje de error.
- Identifica el número de línea que menciona la consola de Shopify en el archivo afectado.
- Verifica que todas las etiquetas condicionales tengan su respectivo cierre:
Disponible{% if product.available %}
- Asegúrate de utilizar correctamente las llaves dobles para variables
{{ variable }}y las llaves con porcentajes para etiquetas lógicas{% tag %}. - Haz clic en Guardar y recarga tu tienda para verificar que el error haya desaparecido.