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

¿Qué es el error "Liquid error: Could not find asset" en Shopify?

Este mensaje de error aparece en la interfaz pública de tu tienda Shopify cuando la plataforma intenta renderizar o cargar un archivo (como un script de JavaScript, una hoja de estilos CSS o una imagen) que no existe o ha sido eliminado de la carpeta de activos (Assets) de tu tema activo. Este fallo perjudica seriamente el diseño visual y el rendimiento técnico de tu e-commerce, afectando la experiencia de usuario y las conversiones.

Causas comunes del error

• Desinstalación incompleta de aplicaciones: Al eliminar una app de Shopify, suele quedar código residual en tus plantillas que sigue buscando los archivos que la aplicación eliminó al ser desinstalada.
• Archivos renombrados o borrados de forma manual: Modificaciones directas en el editor de código donde se elimina un recurso sin retirar su llamada correspondiente en el layout.
• Errores de escritura en el código Liquid: Errores ortográficos al referenciar archivos dentro de etiquetas como asset_url o stylesheet_tag.

Método 1: Localizar y eliminar la referencia huérfana en el código

Si el error apareció tras desinstalar una aplicación o modificar el tema, debes eliminar de forma manual el fragmento de código que intenta llamar al recurso inexistente.

1. Accede a tu panel de administración de Shopify y dirígete a Tienda online y luego a Temas.
2. Haz clic en el botón de los tres puntos junto al tema que deseas editar y selecciona Editar código.
3. En la barra de búsqueda del lateral izquierdo, introduce el nombre del archivo que se menciona en el mensaje de error de tu tienda online.
4. Por lo general, este error se encuentra dentro del archivo theme.liquid (en la carpeta Layout) o en archivos dentro de la carpeta Sections.
5. Busca líneas de código que incluyan el nombre del recurso faltante, por ejemplo: {% render 'nombre-del-archivo' %} o {{ 'archivo.css' | asset_url | stylesheet_tag }}.
6. Elimina por completo la línea de código afectada o coméntala utilizando etiquetas Liquid para que no se ejecute: {% comment %} código {% endcomment %}.
7. Haz clic en Guardar y recarga tu sitio web para comprobar si el error ha desaparecido.

Método 2: Reconstruir o restaurar el archivo faltante en la carpeta Assets

Si el recurso que no se encuentra es fundamental para el diseño, las animaciones o la maquetación de tu tienda Shopify, la mejor alternativa es volver a subir el archivo para restablecer el servicio.

1. Anota el nombre y la extensión exacta del archivo que genera el error en tu navegador web.
2. Accede al editor de código de tu tema en Shopify siguiendo los pasos descritos en el método anterior.
3. En el menú de carpetas de la izquierda, desplázate hacia abajo hasta ubicar la carpeta llamada Assets (Activos).
4. Haz clic en la opción Agregar un nuevo activo.
5. Selecciona subir un archivo desde tu ordenador (si posees una copia de seguridad o el archivo original del tema) o crea un archivo en blanco con el nombre exacto del recurso faltante.
6. Si creaste un archivo vacío, pega el código CSS o JavaScript correspondiente y haz clic en Guardar.
7. Verifica el comportamiento de tu sitio web limpiando la caché del navegador para confirmar que los cambios se visualicen correctamente.