¿Qué es el Liquid Syntax Error en Shopify y por qué ocurre?
El lenguaje de plantillas Liquid es la columna vertebral de Shopify. Cuando modificas el código de tu tienda (archivos .liquid, .json o secciones) y cometes un pequeño error tipográfico, la plataforma interrumpe la carga de la página y muestra un Liquid Syntax Error.
Las causas más comunes de este fallo incluyen:
- Falta de etiquetas de cierre, como
{% endif %}o{% endfor %}. - Errores ortográficos en variables o filtros de Liquid (por ejemplo, escribir
| upcaseeen lugar de| upcase). - Uso incorrecto de comillas o sintaxis en objetos JSON dentro de las secciones.
Método 1: Revisar el registro de errores y la línea de código afectada
Shopify suele ser muy preciso al indicar dónde se encuentra el fallo en tu código.
- Inicia sesión en tu panel de administración de Shopify.
- Ve a Tienda online y luego a Temas.
- Haz clic en los tres puntos (acciones) de tu tema activo y selecciona Editar código.
- Dirígete al archivo que indica el mensaje de error (por ejemplo,
sections/main-product.liquid). - Busca el número de línea exacto que menciona la advertencia de Liquid y verifica que las etiquetas estén correctamente abiertas y cerradas.
Método 2: Deshacer los últimos cambios con el historial de versiones
Si no logras identificar el error tipográfico y necesitas que tu tienda vuelva a funcionar de inmediato, la mejor opción es usar la herramienta de control de versiones integrada de Shopify.
- Dentro del editor de código de tu tema, abre el archivo que presenta el problema.
- En la parte superior del archivo, busca y haz clic en la opción Versiones anteriores (Older versions).
- Selecciona una fecha y hora previa en la que sabías que el código funcionaba perfectamente.
- Haz clic en Guardar para aplicar la versión estable y descartar el código defectuoso.
Método 3: Validar la sintaxis de Liquid antes de guardar
Para prevenir futuros errores en producción, es altamente recomendable realizar pruebas en un tema duplicado.
- Duplica tu tema actual desde el panel de control antes de realizar modificaciones avanzadas.
- Utiliza editores de código externos compatibles con extensiones de Liquid, como Visual Studio Code, que te alertarán en tiempo real sobre etiquetas mal cerradas o errores de sintaxis antes de subirlos a Shopify.