Cómo Solucionar el Error Liquid Error: Could Not Find Asset en Shopify

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

Este fallo ocurre cuando el motor de plantillas de Shopify (Liquid) intenta cargar un archivo de fragmento (snippet) o activo (asset) que ha sido eliminado, renombrado o nunca llegó a crearse en la carpeta correspondiente de tu tema. Es común verlo en la parte superior o inferior del sitio web como un mensaje de texto similar a Liquid error: Could not find asset snippets/nombre-del-archivo.liquid.

Causas comunes del problema

• Desinstalación incompleta de aplicaciones de Shopify que dejaron código residual en los archivos principales del tema.
• Eliminación manual de un archivo en la carpeta Snippets sin borrar la etiqueta de invocación como {% include 'nombre' %} o {% render 'nombre' %}.
• Errores tipográficos al escribir la ruta o nombre del archivo dentro del código Liquid.

Métodos para solucionar el error paso a paso

Método 1: Eliminar la referencia huérfana en el código del tema

1. Desde el panel de administración de Shopify, dirígete a Tienda online y luego a 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 indicado en el error (frecuentemente layout/theme.liquid o una sección específica).
4. Usa el comando Ctrl + F (o Cmd + F en Mac) para buscar el nombre del archivo faltante citado en el fallo.
5. Localiza la línea que contiene {% render 'nombre-del-archivo' %} o {% include 'nombre-del-archivo' %}.
6. Elimina esa línea completa de código y haz clic en Guardar.

Método 2: Volver a crear el archivo faltante en la carpeta Snippets

1. En el editor de código de Shopify, ve a la columna izquierda y busca la carpeta Snippets (Fragmentos).
2. Haz clic en Agregar un nuevo snippet.
3. Escribe exactamente el nombre que requiere el tema (sin la extensión .liquid).
4. Haz clic en Agregar snippet. Puedes dejar el archivo vacío o pegar el código original si dispones de una copia de respaldo.
5. Guarda los cambios y recarga la página principal de tu tienda para comprobar que la advertencia ha desaparecido.

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

1. En el editor de código, abre el archivo del tema donde se genera el error (por ejemplo, theme.liquid).
2. Haz clic en el enlace Versiones anteriores situado junto al nombre del archivo en la parte superior.
3. Selecciona una versión con fecha anterior a la instalación/desinstalación de la app o modificación que causó el fallo.
4. Haz clic en Guardar para restaurar el estado previo del código.