Cómo Solucionar el Error 'Liquid syntax error: Unknown tag' en Shopify

¿Qué es el error 'Liquid syntax error: Unknown tag' en Shopify?

El motor de plantillas de Shopify, denominado Liquid, procesa el diseño visual y la lógica de datos de tu tienda antes de enviar el HTML al navegador del visitante. Cuando el motor detecta una etiqueta que no forma parte de su sintaxis estándar o que ha sido eliminada por cambios en la plataforma, la ejecución se interrumpe y muestra el mensaje Liquid syntax error: Unknown tag seguido del nombre de la etiqueta conflictiva.

Este problema suele romper la maquetación de la página afectada, mostrar mensajes de error directamente a tus clientes o impedir que se muestren elementos cruciales como botones de compra, menús de navegación o carruseles de productos.

Causas frecuentes de este fallo de sintaxis

• Uso de etiquetas obsoletas: Shopify retiró compatibilidad nativa con ciertas etiquetas antiguas (como include en ciertos contextos modernos) obligando al uso de render.
• Código residual de apps desinstaladas: Al eliminar una aplicación desde el panel de control, con frecuencia quedan restos de snippets o etiquetas personalizadas (por ejemplo, {% app_snippet %}) en archivos del tema.
• Errores tipográficos en el código: Errores ortográficos al editar código manualmente, como escribir {% secton %} en lugar de {% section %}, o no cerrar adecuadamente las llaves.

Método 1: Reemplazar etiquetas obsoletas 'include' por 'render'

Con la llegada de Online Store 2.0, muchas plantillas han deprecado o restringido drásticamente el uso de la etiqueta de inclusión tradicional. Si tu error menciona Unknown tag 'include', debes actualizar la sintaxis siguiendo estos pasos:

1. Dirígete al panel de administración de Shopify y navega a Tienda online > Temas.
2. Haz clic en el botón de tres puntos (...) junto a tu tema actual y selecciona Editar código.
3. Localiza el archivo indicado en el mensaje de error o utiliza el buscador superior para buscar la sección o plantilla afectada (por ejemplo, theme.liquid o main-product.liquid).
4. Localiza la línea que contiene la instrucción problemática, como: {% include 'product-card' %}.
5. Reemplázala por la sintaxis moderna: {% render 'product-card' %}.
6. Haz clic en Guardar y recarga tu tienda para verificar que la página cargue sin advertencias.

Método 2: Limpiar etiquetas residuales de aplicaciones de terceros

Si instalaste una app de reseñas, filtros o venta cruzada y luego la eliminaste, es muy probable que haya dejado llamadas a etiquetas que ya no existen en tu servidor.

1. Revisa el nombre de la etiqueta no reconocida en el error (por ejemplo, Unknown tag 'judgeme_widgets' o similar).
2. En el editor de código de tu tema (Tienda online > Temas > Editar código), abre el archivo principal layout/theme.liquid.
3. Pulsa Ctrl + F (o Cmd + F en Mac) y escribe el nombre de la etiqueta huérfana.
4. Elimina la línea completa donde se encuentra la etiqueta o comenta la línea envolviéndola con {% comment %} y {% endcomment %} para no ejecutarla.
5. Revisa también las secciones dentro de la carpeta Sections y snippets en Snippets donde esa app solía operar.
6. Guarda los cambios y comprueba la consola del navegador o la vista previa de la tienda.

Método 3: Revertir el archivo a una versión previa

Si el error apareció después de realizar modificaciones manuales recientes y no recuerdas qué línea provocó la falla, puedes restaurar una versión anterior del archivo afectado mediante el historial integrado de Shopify.

1. Dentro del editor de código de Shopify, abre el archivo que genera el conflicto.
2. Debajo del nombre del archivo en la parte superior del panel de edición, haz clic en el enlace Versiones anteriores (o Older versions).
3. Selecciona una copia de seguridad generada automáticamente con fecha y hora anterior al momento en que apareció el error.
4. Haz clic en Guardar y comprueba si tu tienda vuelve a funcionar con total normalidad.