Introducción
Shopify utiliza un lenguaje de plantillas llamado Liquid para mostrar la información dinámica en las páginas de tu tienda online. Cuando se edita el código de un tema (ya sea Liquid, HTML, CSS o JSON), es muy común cometer errores tipográficos que provocan que la página falle y muestre un mensaje de error de sintaxis en la interfaz de usuario o directamente en el editor de código.
Causas comunes del error de sintaxis Liquid
Los fallos en las plantillas de Shopify suelen deberse a errores humanos básicos durante la personalización del tema. Entre las causas más frecuentes se encuentran:
- Etiquetas de apertura o cierre mal escritas (por ejemplo,
{% if %}sin su correspondiente{% endif %}). - Uso incorrecto de los delimitadores, como olvidar las llaves dobles
{{ }}para variables o las llaves con porcentaje{% %}para lógica. - Filtros mal aplicados o nombres de variables inexistentes en el objeto actual.
- Comillas faltantes o mal cerradas dentro de las sentencias condicionales.
Método 1: Revisar el indicador de error en el editor de código de Shopify
Shopify cuenta con un sistema de validación nativo en su editor de temas que te ayuda a localizar exactamente dónde se encuentra el fallo.
- Inicia sesión en tu panel de administración de Shopify y ve a Canales de venta > Tienda online > Temas.
- Haz clic en el botón de los tres puntos (...) junto al tema que deseas editar y selecciona Editar código.
- Busca el archivo que acabas de modificar. Los archivos con errores de sintaxis suelen mostrar un pequeño punto rojo o un icono de advertencia junto a la línea afectada.
- Haz clic sobre la línea señalada para revisar el mensaje de error específico que genera el compilador de Liquid.
- Corrige el carácter faltante (como un
%}o}}) y haz clic en Guardar.
Método 2: Revertir los cambios usando el historial de versiones del tema
Si has realizado múltiples modificaciones y no logras identificar qué línea de código rompió la sintaxis Liquid, la opción más rápida y segura es volver a una versión anterior del archivo.
- Dentro de la sección Editar código de tu tema en Shopify, abre el archivo exacto que está fallando.
- En la parte superior del editor de código del archivo, busca y haz clic en el enlace que dice Versiones anteriores (Older versions).
- Se desplegará un menú cronológico con las fechas y horas en que se guardó el archivo.
- Selecciona la versión estable anterior al momento en que comenzaste a experimentar el error de sintaxis.
- Haz clic en Guardar para aplicar la versión limpia y funcional.
Método 3: Validar la lógica y sintaxis de las etiquetas condicionales
Muchos errores ocurren al anidar etiquetas lógicas. Asegúrate de que cada bloque esté correctamente cerrado siguiendo este ejemplo correcto de sintaxis Liquid:
{% if product.available %}
<button>Añadir al carrito</button>
{% else %}
<p>Agotado</p>
{% endif %}
Si omites el {% endif %}, el motor de Shopify arrojará un error crítico de plantilla. Revisa minuciosamente tus archivos product-template.liquid, cart.liquid o index.liquid para garantizar que toda la estructura condicional esté balanceada.