¿Qué es un Error de Sintaxis Liquid en Shopify y por qué ocurre?
El lenguaje de plantillas Liquid es el núcleo del diseño y la personalización en Shopify. Cuando realizas modificaciones en el código fuente de tu tema (como en los archivos index.liquid, product-template.liquid o mediante secciones personalizadas) es muy común cometer errores tipográficos. Un error de sintaxis ocurre cuando el motor de Shopify no puede interpretar una etiqueta, un filtro o una variable debido a una errata, un corchete mal cerrado o una sentencia condicional incompleta.
Causas principales de los fallos en Liquid
- Llaves o porcentajes mal cerrados (por ejemplo, usar
{{ product.title }en lugar de cerrar correctamente con}}). - Falta de etiquetas de cierre en bucles o condicionales (como olvidar un
{% endif %}o{% endfor %}). - Uso de filtros o variables obsoletas o mal escritas.
- Modificaciones directas en producción sin realizar pruebas previas en un tema duplicado.
Método 1: Identificar el error a través del editor de temas
Cuando guardas un archivo con errores de sintaxis, Shopify suele mostrar una alerta en la parte superior del editor de código.
- Inicia sesión en tu panel de administración de Shopify y ve a Tienda online > Temas.
- Haz clic en los tres puntos del tema actual y selecciona Editar código.
- Revisa los archivos modificados recientemente; Shopify marcará con un punto rojo o una advertencia la línea exacta donde se encuentra el fallo.
- Corrige el carácter faltante o la etiqueta mal escrita y haz clic en Guardar.
Método 2: Revertir los cambios a una versión anterior
Si no logras localizar el error exacto en el código Liquid y tu tienda muestra una pantalla en blanco o un mensaje de error crítico en el escaparate, la opción más rápida es restaurar una versión previa del archivo.
- Dentro del editor de código de tu tema, abre el archivo que causó el problema.
- Busca justo encima del editor de código el botón que dice Versiones anteriores (Older versions).
- Haz clic en el menú desplegable y selecciona la última versión funcional guardada antes de realizar las modificaciones.
- Haz clic en Guardar para aplicar la versión estable y comprobar que la tienda vuelve a la normalidad.