¿Qué es un Error de Sintaxis Liquid en Shopify?
El lenguaje de plantillas Liquid es el núcleo del diseño y la estructura visual en Shopify. Cuando realizas modificaciones manuales en el código fuente de tu tema (archivos .liquid), es muy común cometer pequeños errores tipográficos, como olvidar cerrar una etiqueta, utilizar una variable mal escrita o malformar un bucle condicional. Esto provoca que la tienda se rompa y muestre un mensaje de error visible tanto para ti como para tus clientes.
Causas Principales del Error
- Etiquetas de control abiertas pero no cerradas, como
{% if %}sin su correspondiente{% endif %}. - Uso de filtros o variables con nombres incorrectos o mal escritos.
- Sintaxis inválida en objetos JSON o delimitadores de salida
{{ }}mezclados con etiquetas{% %}. - Modificaciones en archivos críticos del tema sin realizar una copia de seguridad previa.
Método 1: Identificar la línea exacta mediante el editor de código
- 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 activo y selecciona Editar código.
- Shopify suele indicar el archivo exacto y el número de línea donde ocurrió el fallo de sintaxis en la barra de notificaciones superior o roja.
- Revisa la línea señalada y busca etiquetas huérfanas. Por ejemplo, asegúrate de que cada
{% for item in collection %}termine con un{% endfor %}.
Método 2: Revertir los cambios a una versión anterior
- Si no logras localizar el error visualmente, puedes deshacer la última modificación.
- Dentro del editor de código de Shopify, abre el archivo que editaste recientemente (por ejemplo,
index.liquidomain-product.liquid). - Busca justo encima del nombre del archivo el enlace que dice Versiones anteriores.
- Haz clic en él y selecciona la fecha y hora exacta previa a haber realizado el cambio defectuoso.
- Haz clic en Guardar para restaurar la versión estable del código.