¿Qué es el 'Liquid error: Could not find asset' en Shopify?
Este molesto error visual aparece en la interfaz pública de tu tienda de Shopify cuando el motor de renderizado de plantillas, llamado Liquid, intenta cargar un archivo de código (generalmente un snippet o sección) que ya no existe en el directorio de tu tema activo. Este fallo rompe la estética de tu sitio y genera desconfianza en tus clientes.
Causas comunes del error
- Desinstalación incompleta de aplicaciones: Al eliminar una app de la Shopify App Store, muchas veces quedan rastros de código en tu tema que intentan llamar a archivos que la aplicación ya borró.
- Eliminación accidental de archivos: Borrar snippets, assets o secciones manualmente desde el editor de código sin retirar sus llamadas en el archivo principal.
- Migración de temas defectuosa: Copiar fragmentos de código de un diseño antiguo a uno nuevo sin trasladar todas las dependencias requeridas.
Método 1: Localizar y eliminar la referencia huérfana en el código
La forma más eficiente de solucionar este error es buscar la línea de código exacta que invoca al archivo inexistente y eliminarla.
- Ve a tu panel de administración de Shopify, ingresa a Tienda online y luego a Temas.
- Haz clic en los tres puntos junto a tu tema activo y selecciona Editar código.
- Usa el buscador interno para localizar el archivo principal de tu diseño, que suele ser
theme.liquid. - Presiona
Ctrl + F(oCmd + Fen Mac) y busca el nombre del snippet faltante que se muestra en el mensaje de error. Se verá similar a esto:{% include 'nombre-del-archivo' %}o bien{% render 'nombre-del-archivo' %}. - Elimina por completo esa línea de código o coméntala envolviéndola entre etiquetas de comentario Liquid:
{% comment %}{% render 'nombre-del-archivo' %}{% endcomment %}. - Haz clic en Guardar en la esquina superior derecha y refresca tu tienda para comprobar que el error ha desaparecido.
Método 2: Restaurar el archivo snippet faltante
Si el error se debe a un archivo borrado por accidente que tu tienda realmente necesita para desplegar una funcionalidad crucial, puedes recrearlo fácilmente:
- En la barra lateral del editor de código de tu tema de Shopify, dirígete a la carpeta Snippets.
- Haz clic en el enlace Agregar un nuevo snippet.
- Nombra al archivo con el mismo nombre exacto que aparece en la advertencia de error (por ejemplo,
nombre-del-archivo) y pulsa en Crear. - Pega el código de respaldo correspondiente si lo tienes o, si es un fragmento de una aplicación, vuelve a reinstalar la app o solicita el código de integración a su equipo de soporte técnico.
- Guarda los cambios de inmediato para restablecer el renderizado de la página.
Método 3: Revertir los cambios a una versión anterior del tema
Si el error comenzó a mostrarse tras realizar una edición manual del código y no estás seguro de qué línea alteraste, puedes usar el historial de versiones nativo de Shopify:
- Abre el archivo afectado (generalmente
theme.liquidoproduct-template.liquid) en el editor de código de Shopify. - Busca el enlace que dice Cambios recientes o una marca de tiempo justo al lado del nombre del archivo en la parte superior.
- Haz clic en el menú desplegable y selecciona una versión anterior a la fecha y hora exacta en la que comenzó a surgir el error en tu web.
- Haz clic en Guardar y comprueba el frontend de tu e-commerce.