¿Qué significa el error 'Liquid error: Could not find asset' en Shopify?
Uno de los fallos visuales más frustrantes en Shopify es cuando los visitantes ven un texto plano en el encabezado, pie de página o fichas de producto que dice Liquid error: Could not find asset snippets/.... Este error ocurre cuando el motor de renderizado de plantillas de Shopify (Liquid) intenta cargar un archivo de código externo (generalmente un snippet o asset) que ha sido borrado, renombrado o ya no existe en el directorio del tema activo.
Causas principales de este fallo
- Desinstalación incompleta de aplicaciones: Al desinstalar una app desde el panel de Shopify, los scripts insertados dentro del archivo
theme.liquido en las secciones no siempre se eliminan de forma automática, dejando llamadas a archivos inexistentes. - Eliminación accidental de snippets: Modificaciones manuales en el editor de código donde se borra un archivo
.liquiddentro de la carpeta Snippets sin retirar su invocación previa. - Errores al migrar temas: Copiar fragmentos de código entre diferentes versiones de plantillas sin trasladar todas las dependencias y librerías asociadas.
Método 1: Localizar y eliminar la referencia rota en el código
La forma más rápida y directa de resolverlo es remover la etiqueta de inclusión que apunta al archivo ausente:
- Accede a tu panel de administración de Shopify y dirígete a Canales de venta > Tienda online > Temas.
- En el tema publicado actualmente, haz clic en el botón de los tres puntos (...) y selecciona Editar código.
- Observa con atención el texto exacto del error en tu tienda; por ejemplo, si dice
snippets/app-review.liquid, busca el nombre del archivo en el buscador de la barra lateral izquierda. - Abre el archivo principal
theme.liquid(ubicado en la carpeta Layout) o el archivo de la sección donde aparece el mensaje. - Presiona
Ctrl + F(oCmd + Fen Mac) y busca la etiqueta Liquid:{% render 'nombre-del-archivo' %}o{% include 'nombre-del-archivo' %}. - Elimina la línea completa que contiene esa instrucción o coméntala envolviéndola con
{% comment %}y{% endcomment %}. - Haz clic en Guardar y recarga la página afectada de tu tienda en modo incógnito para verificar la solución.
Método 2: Recrear el snippet vacío para suprimir el error
Si no estás seguro de qué archivo está llamando al asset faltante o no quieres alterar la plantilla principal por miedo a romper la estructura visual, puedes crear un archivo puente temporal:
- Dentro del editor de código de Shopify, dirígete a la carpeta Snippets.
- Haz clic en Agregar un nuevo snippet.
- Asigna exactamente el mismo nombre que muestra el mensaje de error (por ejemplo, si el error es
snippets/social-icons.liquid, escribesocial-icons). - Deja el archivo completamente en blanco y presiona Guardar.
- Al existir el archivo (aunque esté vacío), el motor Liquid encontrará el recurso y el mensaje desaparecerá de forma instantánea.
Método 3: Restaurar una versión anterior del archivo afectado
Si el error comenzó a mostrarse tras haber realizado cambios manuales recientes en archivos esenciales como theme.liquid, puedes volver a un estado funcional previo:
- Ve a Tienda online > Temas > Editar código.
- Selecciona el archivo que fue modificado recientemente.
- Cerca del nombre del archivo, haz clic en Versiones anteriores.
- Selecciona una copia con fecha y hora anterior a la aparición del error.
- Haz clic en Guardar para restablecer el tema a su versión estable previa.