Cómo Solucionar el Error 'Liquid error: Could not find asset' en Shopify

¿Qué causa el fallo 'Liquid error: Could not find asset' en Shopify?

Este error de renderizado ocurre cuando el motor de plantillas Liquid de Shopify intenta cargar un archivo recurso (como un script JavaScript, hoja de estilo CSS, imagen o snippet) que ya no existe en la carpeta Assets de la tienda. Es muy habitual tras desinstalar aplicaciones del App Store, modificar manualmente el código o subir un tema personalizado incompleto.

Causas principales del error

• Llamadas residuales de aplicaciones de Shopify que fueron desinstaladas pero dejaron fragmentos de código.
• Eliminación accidental de archivos dentro del directorio Assets o Snippets.
• Errores tipográficos en las etiquetas Liquid al referenciar un recurso mediante el filtro asset_url.

Método 1: Eliminar o corregir la referencia en el código del tema

Si la aplicación o el archivo ya no es necesario, lo más rápido es retirar la línea de código que causa el conflicto en tu archivo principal de la plantilla.

1. En tu panel de control de Shopify, ve a Tienda online > Temas.
2. Haz clic en el botón de tres puntos junto a tu tema activo y selecciona Editar código.
3. Abre el archivo layout/theme.liquid (o el archivo específico donde aparezca el fallo).
4. Utiliza la combinación de teclas Ctrl + F (o Cmd + F en Mac) y busca el nombre del archivo mencionado en el mensaje de error.
5. Borra la etiqueta Liquid completa que intenta cargar el archivo, por ejemplo: {{ 'nombre-archivo.js' | asset_url | script_tag }}.
6. Haz clic en Guardar para aplicar los cambios y recarga tu tienda.

Método 2: Restaurar o subir el archivo faltante

Si el error rompió el diseño visual o la funcionalidad de una sección activa, necesitarás volver a subir el archivo que Shopify está buscando.

1. Accede al panel de Editar código de tu tema activo.
2. Localiza el directorio Assets en la barra lateral izquierda y haz clic en Agregar un nuevo recurso.
3. Sube el archivo omitido garantizando que el nombre coincida exactamente con el texto de la alerta (respetando mayúsculas, minúsculas y extensiones como .css o .js).
4. Si el recurso faltante es un snippet, ve a la carpeta Snippets, selecciona Agregar un nuevo snippet y asígnale el nombre solicitado.

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

Shopify guarda un historial de modificaciones de los archivos Liquid, lo que permite volver a una copia funcional antes de que ocurriera el problema.

1. Abre el archivo donde reside la llamada rota desde el editor de código (por ejemplo, theme.liquid).
2. Debajo del nombre del archivo en la parte superior del editor, haz clic en Versiones anteriores.
3. Selecciona un punto de restauración con fecha previa a la aparición del error y presiona Guardar.