Error de imágenes en PrestaShop (cPanel): Causas y soluciones

¿Por qué no se muestran las imágenes en mi tienda PrestaShop?

Es una de las consultas más habituales en soporte técnico. Ves tu tienda, pero en lugar de los productos aparecen recuadros en blanco, iconos rotos o el clásico "alt" en texto. Este problema es frustrante, sobre todo porque afecta directamente a la conversión: nadie compra lo que no ve.

Las causas pueden ser varias, desde permisos de archivos incorrectos hasta un problema con la caché. La buena noticia es que la gran mayoría de los casos se pueden resolver siguiendo un orden lógico de comprobaciones. Vamos a ello, paso a paso, sin necesidad de ser un experto en desarrollo.

Primeros pasos: diagnóstico rápido desde cPanel

Antes de tocar nada, es fundamental saber si el problema es general (toda la tienda) o específico (solo algunas imágenes). Esto nos dará pistas sobre el origen.

Comprueba el estado de los archivos de imagen

Accede a tu panel de control cPanel y sigue estos pasos:

Abre el Administrador de archivos.
Navega hasta la carpeta de tu tienda (normalmente public_html o una subcarpeta si la tienes en un directorio propio).
Entra en la ruta: img/p o img/c (dependiendo de si son productos o categorías).
Observa si ves los archivos con extensiones .jpg, .png o .webp. Si no ves nada o la carpeta está vacía, el problema es de origen. Si ves los archivos, el problema está en cómo el servidor los está sirviendo.

Verifica los permisos de archivos y carpetas (CHMOD)

Los permisos incorrectos son la causa número uno de este error. El servidor necesita "leer" los archivos para mostrarlos. Si los permisos son demasiado restrictivos, el servidor web (Apache o LiteSpeed) no puede acceder a ellos.

Debes asegurarte de que las carpetas tengan permisos 755 y los archivos 644.

[WARNING] Cambiar los permisos de forma masiva puede ser peligroso si no sabes lo que haces. Hazlo solo sobre las carpetas img, themes, modules y upload en PrestaShop.

Para cambiarlos desde cPanel:

Selecciona la carpeta img en el Administrador de archivos.
Haz clic derecho y elige Cambiar permisos.
Marca las casillas para establecer 755 (lectura y ejecución para todos, escritura solo para el propietario).
Marca la casilla "Cambiar los archivos y carpetas dentro" si tu versión de cPanel lo permite.
Haz clic en Cambiar permisos.

Repite este proceso para las carpetas themes y modules. A veces, con solo hacer esto en img, el problema se resuelve al instante, ya que es donde se almacenan las fotos de los productos.

Solucionar el error de imágenes PrestaShop desde el Back Office

Si los permisos están bien, el siguiente paso es regenerar las miniaturas. PrestaShop a veces pierde la referencia de las imágenes redimensionadas (las que usa en las listas de productos y en la página de inicio).

Regenerar las miniaturas

Este proceso es la solución más común para el error de imágenes PrestaShop. Es como "resetear" la caché de imágenes.

Inicia sesión en tu back office de PrestaShop.
Ve al menú Diseño o Preferences (depende de la versión, puede ser Diseño > Imágenes o Configuración avanzada > Imágenes).
En la parte inferior de la pantalla, verás la opción "Regenerar miniaturas".
Selecciona la opción "Elegir imágenes" y marca todas las casillas (productos, categorías, etc.). Si no sabes cuál elegir, marca "Todos".
Haz clic en "Regenerinar" y espera a que termine. Puede tardar varios minutos si tienes muchos productos.

[TIP] Si tu tienda tiene más de 500 productos, haz la regeneración por lotes. Selecciona solo "Productos" primero y luego "Categorías". Así evitas que el servidor se sature y dé un error de tiempo de ejecución (timeout).

Limpia la caché de PrestaShop

Después de regenerar, es vital limpiar la caché. A veces, el navegador o el propio PrestaShop guardan una versión antigua de la página.

Ve a Configuración avanzada > Rendimiento.
En la opción "Caché", selecciona "Sí" y luego haz clic en "Vaciar la caché" (el botón con el icono de una escoba).
También puedes forzar la compilación de plantillas en "Plantillas" marcando la casilla "Forzar la compilación" y guardando. Luego desmárcala para no perder rendimiento.

Errores de URL y configuración de la tienda

Otra causa muy común es tener mal configurada la URL base de la tienda o haber cambiado el dominio recientemente.

Revisa la URL canónica en la base de datos

Si has cambiado tu dominio o lo has movido de un subdominio a un dominio principal, las rutas de las imágenes en la base de datos siguen apuntando a la URL antigua.

Puedes comprobarlo accediendo a phpMyAdmin desde cPanel:

Abre phpMyAdmin.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_configuration (el prefijo puede variar, a veces es ps_ u otro).
Busca los campos PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Asegúrate de que contienen tu dominio actual sin http:// ni https:// (por ejemplo: www.tutienda.com).

Si no te sientes cómodo editando la base de datos, puedes hacerlo desde el back office en Configuración > Parámetros generales, pero a veces la base de datos es la única vía si el back office no carga bien.

Fuerza la regeneración de URLs con un archivo .htaccess

A veces, el archivo .htaccess está corrupto o no tiene las reglas necesarias para servir las imágenes correctamente.

Ve al Administrador de archivos de cPanel.
Activa la opción "Mostrar archivos ocultos" (en la esquina superior derecha).
Busca el archivo .htaccess en la raíz de tu instalación de PrestaShop.
Descárgalo como copia de seguridad.
Bórralo del servidor.
Ve al back office de PrestaShop y entra en cualquier página de configuración. PrestaShop lo regenerará automáticamente. Si no lo hace, ve a Configuración avanzada > Rendimiento y pulsa el botón "Guardar" en la parte inferior de la página para forzar la regeneración.

[WARNING] Si borras el .htaccess y no dejas que se regenere, tu tienda puede dejar de funcionar. Hazlo solo si estás seguro de poder regenerarlo.

Problemas con el módulo de optimización de imágenes

Muchas tiendas usan módulos de compresión de imágenes (como Smush o similar) que a veces entran en conflicto.

Desactiva módulos recientes o de imágenes

Si el problema empezó después de instalar un módulo nuevo, ese es el culpable.

Ve a Módulos > Administrador de módulos.
Busca cualquier módulo relacionado con imágenes, caché o CDN.
Desactívalo y prueba de nuevo.

Si la tienda vuelve a la normalidad, el problema es del módulo. Contacta con el soporte del módulo o busca una alternativa.

El servidor: límites de memoria y tiempo de ejecución

PrestaShop es exigente. Si el servidor tiene poca memoria PHP, el proceso de regenerar imágenes falla a mitad de camino y deja los archivos corruptos o incompletos.

Aumenta la memoria PHP desde cPanel

Este es un paso casi obligatorio para solucionar imágenes PrestaShop que no cargan.

Ve a Seleccionar versión de PHP en cPanel (o "MultiPHP Manager").
Haz clic en "Opciones de PHP" o el icono de ajustes.
Busca la variable memory_limit. Cámbiala a 512M o incluso 1024M si tu plan lo permite.
También aumenta max_execution_time a 300 (segundos) para evitar que el proceso se corte.
Guarda los cambios.

Después de esto, vuelve a intentar regenerar las miniaturas.

[INFO] Si tu hosting no te permite modificar estos valores desde cPanel, tendrás que crear un archivo php.ini en la raíz de tu PrestaShop. Pide a tu proveedor que te indique la ruta correcta.

Cuando todo lo demás falla: el CDN o el almacenamiento

Si usas un CDN (Content Delivery Network) como Cloudflare, es posible que esté sirviendo una versión antigua de las imágenes.

Purga la caché del CDN

Accede al panel de tu CDN.
Busca la opción "Purge Cache" o "Limpiar caché".
Purgala por completo (no solo por URL).

Esto forzará al CDN a buscar las imágenes nuevas desde tu servidor.

Desactiva el CDN temporalmente

Para descartar que el CDN sea el problema, desactívalo temporalmente (en modo desarrollo) y mira si las imágenes cargan. Si cargan, el problema es la configuración del CDN. Asegúrate de que las reglas de caché no estén bloqueando las extensiones de imagen.

Conclusión y prevención

Solucionar el error de imágenes en PrestaShop suele ser un proceso de eliminación. Empieza por lo más simple (permisos, caché) y ve subiendo en complejidad (base de datos, memoria PHP). Te recomiendo que después de cada cambio, hagas una prueba en una ventana de incógnito para evitar la caché de tu navegador.

Para prevenir futuros problemas:

No instales módulos de terceros que no sean de confianza.
Mantén tu PrestaShop y los módulos siempre actualizados.
Realiza copias de seguridad periódicas de la carpeta img y de la base de datos.

Si después de todos estos pasos el problema persiste, es muy probable que sea un tema de configuración del servidor a nivel más profundo. En ese caso, contacta con tu proveedor de hosting y muéstrales este artículo para que sepan por dónde has ido descartando. Con un poco de paciencia, tu tienda volverá a lucir perfecta.