¿Qué causa el error 'Liquid error: Could not find asset snippets' en Shopify?
Este error en Shopify se produce cuando el motor de renderizado Liquid intenta cargar un fragmento de código (snippet) que ya no existe en el directorio snippets de tu tema activo. Es un problema muy común en tiendas online que suele ocurrir por las siguientes razones:
- Desinstalación incompleta de aplicaciones: Muchas apps de la Shopify App Store inyectan etiquetas como
{% include 'app-snippet' %}o{% render 'app-snippet' %}en tus archivos principales (comotheme.liquidoproduct.liquid) y no las eliminan al ser desinstaladas. - Eliminación accidental de archivos: Borrar manualmente un archivo con extensión
.liquiddentro de la carpeta Snippets sin retirar las llamadas correspondientes en las plantillas o secciones. - Migración o duplicación defectuosa del tema: Copiar fragmentos de código entre temas diferentes sin transferir todos los archivos dependientes.
Método 1: Localizar y eliminar la referencia huérfana en el código
La forma más directa de solucionar este error consiste en eliminar la línea de código que intenta invocar el archivo faltante.
- Accede a tu panel de administración de Shopify y ve a Tienda online > Temas.
- Junto a tu tema publicado, haz clic en el botón de los tres puntos (...) y selecciona Editar código.
- Observa el mensaje de error en tu tienda; este indicará el nombre exacto del archivo que falta (por ejemplo:
snippets/review-widget.liquid). - Abre el archivo principal
theme.liquid(ubicado en la carpeta Layout) o la plantilla donde se muestra el error (comomain-product.liquiden Sections). - Usa el atajo de búsqueda
Ctrl + F(oCmd + Fen Mac) y busca el nombre del snippet problemático o las etiquetasrenderoincludeasociadas. - Elimina la línea completa que contiene el código similar a:
{% render 'nombre-del-snippet' %}o{% include 'nombre-del-snippet' %}. - Haz clic en Guardar en la esquina superior derecha y recarga tu tienda para verificar que el error haya desaparecido.
Método 2: Restaurar una versión anterior del archivo Liquid
Si el error apareció después de realizar modificaciones manuales recientes y no estás seguro de qué líneas causaron el conflicto, puedes revertir el archivo a un estado funcional anterior.
- Dentro del editor de código de Shopify, abre el archivo que está generando la llamada al snippet roto (habitualmente
layout/theme.liquid). - En la parte superior del editor, justo al lado del nombre del archivo, haz clic en el enlace Versiones anteriores (o Older versions).
- Selecciona una versión con fecha y hora anterior al momento en que comenzó a mostrarse el error.
- Haz clic en Restaurar y guarda los cambios para regresar al código estable.
Método 3: Recrear temporalmente el archivo snippet vacío
Si no encuentras dónde se está ejecutando la llamada Liquid debido a estructuras complejas del tema, puedes crear un archivo vacío para silenciar el error de inmediato mientras depuras el código.
- En el menú lateral del editor de código, dirígete a la sección Snippets y haz clic en Agregar un nuevo snippet.
- Escribe exactamente el mismo nombre del snippet que el mensaje de error indica que no se encuentra (sin incluir la extensión
.liquid, ya que Shopify la añade automáticamente). - Deja el archivo completamente en blanco y presiona Guardar.
- Al existir el archivo, el motor Liquid ya no lanzará una excepción crítica y tu tienda volverá a mostrarse con normalidad.