Migrar la biblioteca de medios en WordPress sin perder imágenes

Hay migraciones de WordPress que parecen ir bien hasta que entras en la biblioteca de medios.

La web carga, las páginas están ahí, el panel funciona… pero empiezas a revisar imágenes y algo no cuadra: archivos que no aparecen, fotos rotas, imágenes destacadas perdidas, URLs antiguas o una carpeta uploads llena de archivos que WordPress parece no reconocer.

Migrar la biblioteca de medios en WordPress no es solo copiar imágenes de una carpeta a otra. También hay que entender cómo WordPress registra esos archivos en la base de datos y cómo los relaciona con entradas, páginas, productos, imágenes destacadas o documentos descargables.

Y ahí empiezan los sustos.

Porque una cosa es tener las imágenes guardadas en el servidor y otra muy distinta es que WordPress las reconozca, las muestre en el panel, mantenga sus URLs y las asocie correctamente con cada página.

Qué significa migrar la biblioteca de medios en WordPress

La biblioteca de medios de WordPress es el lugar donde se gestionan imágenes, PDFs, documentos, vídeos, iconos y otros archivos subidos desde el panel.

Cuando subes una imagen a WordPress, no ocurre solo una cosa.

Ocurren varias:

• El archivo se guarda físicamente en el servidor.
• WordPress crea un registro en la base de datos.
• Se generan miniaturas o tamaños adicionales si la configuración lo indica.
• El archivo queda disponible en la biblioteca de medios.
• Puede asociarse a una entrada, página, producto o imagen destacada.
• Se guarda una URL para poder mostrarlo en la web.

Por eso, cuando hablamos de migrar la biblioteca de medios, no hablamos solo de “pasar fotos”.

Hablamos de mover archivos, conservar rutas, registrar adjuntos, revisar URLs y comprobar que la web sigue mostrando las imágenes donde debe.

Ese detalle es el que suele pillar por sorpresa.

Archivos en uploads y biblioteca de medios: no es lo mismo

La mayoría de archivos subidos a WordPress se guardan dentro de esta carpeta:

wp-content/uploads

Normalmente, WordPress organiza los archivos por año y mes:

wp-content/uploads/2026/07/imagen-ejemplo.jpg

Si copias esa carpeta a otro WordPress, los archivos estarán en el servidor nuevo.

Pero eso no significa que aparezcan automáticamente en la biblioteca de medios.

Para entenderlo fácil:

Elemento	Dónde está	Qué pasa si falta
Archivo físico	Carpeta wp-content/uploads	La imagen no puede cargarse porque el archivo no existe en el servidor.
Registro en base de datos	Tablas de WordPress	El archivo puede existir, pero no aparecer en la biblioteca de medios.
URL del archivo	Contenido, metadatos y base de datos	La web puede intentar cargar imágenes desde el dominio antiguo.
Relación con páginas o productos	Entradas, páginas, productos o campos personalizados	La imagen puede no mostrarse como destacada o no aparecer donde estaba antes.

Este es el motivo por el que algunas migraciones parecen correctas por FTP, pero luego el panel de WordPress muestra una biblioteca vacía o incompleta.

Los archivos están ahí, sí.

Pero WordPress no siempre se ha enterado.

Antes de migrar: copia de seguridad y revisión básica

Antes de tocar nada, conviene hacer una copia de seguridad.

No una copia mental.

No un “creo que el hosting hace copias”.

Una copia real de archivos y base de datos.

Esto es especialmente importante si vas a migrar una web con muchas imágenes, productos WooCommerce, entradas antiguas, documentos descargables o contenido que ya está posicionado.

Antes de empezar, revisa:

• Cuánto pesa la carpeta uploads.
• Si la web usa imágenes destacadas.
• Si hay productos con galerías.
• Si existen PDFs o documentos enlazados desde páginas importantes.
• Si el dominio va a cambiar.
• Si las URLs de las imágenes incluyen el dominio antiguo.
• Si hay CDN, caché o plugins de optimización de imágenes.
• Si el nuevo hosting tiene espacio suficiente.

Método 1: migrar toda la web WordPress completa

Si lo que quieres es mover una web WordPress de un servidor a otro, muchas veces lo más limpio no es migrar solo la biblioteca de medios.

Lo más seguro puede ser migrar la web completa: archivos, base de datos, plugins, tema, configuraciones y carpeta uploads.

Este método tiene sentido cuando:

• Vas a cambiar de hosting.
• Vas a clonar la web en otro dominio.
• Quieres mover todo el WordPress, no solo las imágenes.
• La biblioteca de medios está muy ligada a entradas, productos o páginas.
• No quieres perder relaciones entre imágenes destacadas, galerías y contenidos.

Para una migración completa se pueden usar herramientas especializadas, copias del hosting, plugins de migración o trabajo manual con archivos y base de datos.

La ventaja es que se conserva mejor el conjunto.

La desventaja es que hay que hacerlo con cuidado: rutas, dominio, base de datos, usuarios, permisos, plugins, caché y SSL pueden dar guerra si se toca sin revisar.

Migrar una web no es meterla en una bolsa y cruzar la calle. A veces se parece más a una mudanza con cajas sin etiquetar: si no sabes dónde va cada cosa, al llegar al destino empiezan las sorpresas.

Método 2: copiar uploads por FTP y registrar los medios

Este método sirve cuando quieres mover los archivos de la biblioteca multimedia, pero no necesariamente toda la web.

La idea es sencilla:

1. Acceder al servidor antiguo por FTP o administrador de archivos.
2. Descargar la carpeta wp-content/uploads.
3. Subirla al nuevo sitio en la misma ruta.
4. Registrar esos archivos en WordPress si no aparecen en la biblioteca.

La primera parte es fácil de entender.

La segunda es donde vienen los matices.

Si subes los archivos por FTP, WordPress no siempre los registra automáticamente como adjuntos. Para eso puedes necesitar un plugin que sincronice archivos del servidor con la biblioteca de medios o un proceso técnico con WP-CLI.

Cuándo encaja este método

• Cuando ya tienes los archivos descargados.
• Cuando necesitas rescatar imágenes de una web antigua.
• Cuando la carpeta uploads se ha copiado, pero la biblioteca aparece vacía.
• Cuando no quieres migrar toda la web completa.
• Cuando necesitas importar solo parte de los medios.

Riesgos de hacerlo solo por FTP

• Las imágenes pueden no aparecer en la biblioteca.
• Las miniaturas pueden faltar o no generarse correctamente.
• Las URLs pueden seguir apuntando al dominio antiguo.
• Las imágenes destacadas pueden perder su relación con páginas o entradas.
• Puede haber problemas de permisos en carpetas y archivos.

Método 3: registrar archivos con un plugin de medios

Hay casos en los que los archivos ya están en el servidor, pero no aparecen en la biblioteca de medios.

Esto suele ocurrir cuando se han subido por FTP, se han restaurado desde una copia parcial o se han movido manualmente.

En ese escenario puedes usar un plugin pensado para detectar archivos dentro de uploads y registrarlos en WordPress.

Uno de los plugins habituales para este tipo de tarea es Media Sync. Su función es revisar archivos presentes en el servidor y sincronizarlos con la biblioteca multimedia.

Este tipo de plugin puede ser útil, pero conviene usarlo con cabeza.

Antes de sincronizar cientos o miles de archivos, revisa:

• Que la carpeta correcta sea la que vas a importar.
• Que no estés duplicando archivos ya existentes.
• Que el servidor tenga recursos suficientes.
• Que tengas una copia de seguridad reciente.
• Que el plugin esté actualizado y sea compatible con tu versión de WordPress.

Si tienes una biblioteca pequeña, puede ser un camino cómodo.

Si tienes miles de imágenes, productos o archivos pesados, mejor ir con más cuidado. Un plugin puede ayudarte, pero también puede dejarte una biblioteca duplicada, incompleta o llena de adjuntos que luego nadie sabe de dónde han salido.

Método 4: importar medios con WP-CLI

WP-CLI es una herramienta de línea de comandos para trabajar con WordPress desde el servidor.

Es una opción potente para usuarios técnicos, administradores de sistemas o desarrolladores que necesitan importar muchos archivos sin depender del panel de WordPress.

El comando más habitual para importar medios es:

wp media import /ruta/a/tus/archivos/*.jpg

También se pueden importar otros formatos y rutas, según el caso.

La ventaja de WP-CLI es que permite registrar archivos en la biblioteca de medios de forma más controlada y rápida que hacerlo manualmente desde el panel.

La desventaja es clara: si no sabes lo que estás haciendo, mejor no improvisar.

WP-CLI no es peligroso por sí mismo. Lo peligroso es usarlo como quien toca botones en una cabina de avión porque “más o menos se entiende”.

Cuándo usar WP-CLI para importar medios

• Cuando tienes acceso SSH al servidor.
• Cuando necesitas importar muchos archivos.
• Cuando el panel de WordPress se queda corto.
• Cuando quieres automatizar parte del proceso.
• Cuando sabes revisar errores y resultados después de ejecutar comandos.

Qué revisar después de usar WP-CLI

• Que los archivos aparecen en la biblioteca de medios.
• Que las miniaturas se han generado correctamente.
• Que las URLs son correctas.
• Que no se han creado duplicados innecesarios.
• Que las páginas siguen mostrando las imágenes esperadas.

Método 5: exportar e importar medios desde WordPress

WordPress incluye una herramienta de exportación e importación que puede servir en algunos casos.

Desde el sitio de origen puedes ir a:

Herramientas > Exportar

Y seleccionar contenido o medios según lo que necesites.

Después, en el sitio de destino, puedes usar:

Herramientas > Importar

Este método puede ser útil cuando quieres mover contenidos y adjuntos entre instalaciones WordPress sin entrar en FTP o base de datos.

Ahora bien, no lo trataría como solución universal.

Puede fallar o quedarse corto si:

• La biblioteca es muy grande.
• El servidor tiene límites de tiempo o memoria.
• El sitio de origen ya no está accesible.
• Hay muchas imágenes pesadas.
• El XML de exportación es demasiado grande.
• Hay archivos protegidos, rutas raras o permisos incorrectos.

Para una web pequeña puede servir.

Para una web grande, una tienda online o una migración delicada, conviene revisar otro método.

Qué hacer si las imágenes no aparecen en la biblioteca

Este es uno de los problemas más comunes.

Has subido los archivos a wp-content/uploads, entras en WordPress y la biblioteca no muestra nada nuevo.

Lo primero: no significa necesariamente que hayas perdido los archivos.

Puede significar simplemente que WordPress no los ha registrado.

Revisa esto:

1. Comprueba la ruta: asegúrate de que los archivos están dentro de la carpeta correcta.
2. Revisa permisos: las carpetas y archivos deben tener permisos adecuados para que WordPress pueda leerlos.
3. Comprueba fechas: si WordPress organiza por año y mes, revisa si estás buscando en el sitio correcto.
4. Usa un plugin de sincronización: puede ayudarte a registrar archivos existentes en el servidor.
5. Valora WP-CLI: si tienes acceso técnico, puede ser una opción más limpia para importar muchos medios.

Qué hacer si las imágenes se ven rotas tras la migración

Otro caso frecuente: la biblioteca parece estar bien, pero las imágenes no cargan en la web.

Puede aparecer el icono de imagen rota, espacios vacíos, fondos que no se ven o productos sin foto.

En ese caso, conviene revisar varias cosas.

Problema	Qué puede estar pasando	Qué revisar
URLs del dominio antiguo	La web intenta cargar imágenes desde la URL anterior.	Base de datos, contenido, campos personalizados y reemplazo de URLs.
Archivos no copiados	La base de datos apunta a imágenes que no existen en el servidor.	Carpeta uploads completa y rutas por año/mes.
Permisos incorrectos	El servidor tiene archivos, pero no puede servirlos correctamente.	Permisos de carpetas, archivos y propietario del servidor.
Miniaturas faltantes	WordPress no encuentra tamaños generados para ciertas imágenes.	Regeneración de miniaturas y tamaños de imagen.
Caché o CDN	La web sigue mostrando rutas antiguas o archivos no actualizados.	Caché de WordPress, caché del servidor, CDN y navegador.
Plugins de optimización	El plugin genera rutas WebP, copias o versiones que no se han migrado bien.	Configuración del plugin y carpetas de imágenes optimizadas.

Si el problema es de URLs antiguas, una herramienta de búsqueda y reemplazo puede ayudar.

Plugins como Better Search Replace pueden servir para sustituir el dominio antiguo por el nuevo dentro de la base de datos.

Pero cuidado: antes de reemplazar nada, copia de seguridad.

Un reemplazo mal hecho puede arreglar imágenes y romper enlaces, serializados, configuraciones o rutas internas. No es un botón para pulsar con alegría de viernes.

Qué pasa con las imágenes destacadas

Las imágenes destacadas merecen una mención aparte.

En WordPress, una imagen destacada no es solo una foto puesta dentro del contenido. Es una relación entre una entrada, página, producto o post type y un adjunto de la biblioteca.

Si al migrar se pierden registros, IDs o relaciones, puede ocurrir que:

• Las entradas sigan existiendo, pero sin imagen destacada.
• Los productos de WooCommerce pierdan su imagen principal.
• Las galerías no se muestren correctamente.
• El tema deje huecos vacíos donde antes había imágenes.
• El contenido tenga imágenes dentro, pero no destacada en listados.

Por eso, cuando la biblioteca de medios forma parte de una web con blog, tienda o portfolio, conviene migrar con más cuidado.

Una imagen destacada perdida puede parecer un detalle pequeño. Hasta que entras en una categoría con 80 entradas y todas parecen fichas sin cara.

Errores frecuentes al migrar medios en WordPress

Estos son errores que vemos a menudo en migraciones mal planteadas.

Copiar solo uploads y pensar que está todo hecho

La carpeta uploads es esencial, pero no siempre basta. Si WordPress no registra los adjuntos o si las URLs no se actualizan, la migración queda a medias.

No revisar el dominio antiguo en la base de datos

Si cambias de dominio, puede que muchas imágenes sigan apuntando a la URL anterior.

Esto puede pasar en contenido, constructores visuales, campos personalizados, opciones del tema o plugins.

No hacer copia antes de reemplazar URLs

Buscar y reemplazar en base de datos puede ser útil, pero también peligroso si se hace sin copia.

Primero copia. Luego pruebas. Después respiras.

Olvidar las miniaturas

WordPress genera varios tamaños de cada imagen. Si faltan, algunas zonas de la web pueden cargar mal aunque la imagen original exista.

No comprobar formularios, productos o páginas importantes

Una migración no se valida mirando solo la home.

Hay que revisar páginas internas, blog, productos, formularios, galerías y zonas donde las imágenes cumplen una función importante.

No limpiar caché

Después de migrar, la caché puede seguir mostrando rutas antiguas o versiones previas de archivos.

Conviene limpiar caché de WordPress, servidor, CDN y navegador cuando proceda.

Checklist después de migrar la biblioteca de medios

Después de la migración, revisa estos puntos antes de dar el trabajo por terminado.

• La biblioteca de medios muestra los archivos esperados.
• Las imágenes cargan en la home.
• Las imágenes cargan en páginas internas.
• Las imágenes destacadas siguen asociadas.
• Los productos, si hay WooCommerce, conservan fotos y galerías.
• Los PDFs y documentos descargables funcionan.
• Las URLs apuntan al dominio correcto.
• No hay rutas antiguas visibles en el código o base de datos.
• Los permisos de carpetas y archivos son correctos.
• La caché se ha limpiado.
• Las miniaturas se generan correctamente.
• Las imágenes importantes tienen ALT si procede.

Cuándo pedir ayuda para migrar una biblioteca grande

Si tienes pocas imágenes y una web sencilla, quizá puedes hacer la migración con calma siguiendo uno de los métodos anteriores.

Pero hay casos donde merece la pena pedir ayuda antes de tocar.

• La web tiene miles de imágenes.
• Hay una tienda WooCommerce con productos y galerías.
• Vas a cambiar de dominio.
• La biblioteca ya está dando errores.
• Hay imágenes rotas después de una migración previa.
• La web usa constructores visuales o campos personalizados.
• Hay CDN o plugins de optimización de imágenes.
• No tienes claro si la copia de seguridad está completa.
• Necesitas migrar sin perder posicionamiento ni contenido importante.

En esos casos, improvisar puede salir caro.

Una migración mal hecha no siempre rompe la web entera. A veces rompe justo lo suficiente para que parezca que todo está bien hasta que un cliente entra, no ve una imagen, no descarga un PDF o encuentra un producto sin foto.

Y ese tipo de fallo es incómodo porque no siempre grita. A veces se queda escondido.

Cómo podemos ayudarte en ideaWeb

En ideaWeb podemos ayudarte a revisar y corregir problemas relacionados con la biblioteca de medios de WordPress, especialmente cuando vienen de migraciones incompletas, cambios de hosting, cambios de dominio o restauraciones mal hechas.

Podemos revisar:

• Carpeta wp-content/uploads.
• Biblioteca de medios.
• URLs antiguas y rutas rotas.
• Imágenes destacadas.
• Galerías y productos WooCommerce.
• Permisos de archivos y carpetas.
• Caché y CDN.
• Base de datos y reemplazos necesarios.
• Relación entre imágenes, páginas, entradas y productos.

También podemos ayudarte si estás cambiando de hosting o quieres alojar tu WordPress en un entorno más cuidado. Una migración no debería ser una aventura con final incierto.

Si la web es importante para tu negocio, conviene moverla con método, copia y revisión. Menos ruleta rusa y más checklist.

Preguntas frecuentes sobre migrar la biblioteca de medios en WordPress

¿Dónde guarda WordPress las imágenes subidas?

WordPress guarda normalmente las imágenes y archivos subidos en la carpeta wp-content/uploads, organizada por años y meses si esa opción está activa.

¿Basta con copiar la carpeta uploads para migrar la biblioteca de medios?

No siempre. Copiar uploads mueve los archivos físicos, pero WordPress también necesita registros en la base de datos para que aparezcan correctamente en la biblioteca de medios.

¿Por qué mis imágenes no aparecen en la biblioteca después de subirlas por FTP?

Porque WordPress no registra automáticamente todos los archivos subidos por FTP. Puede ser necesario sincronizarlos con un plugin o importarlos mediante WP-CLI.

¿Qué hago si las imágenes se ven rotas tras una migración?

Revisa si los archivos existen en uploads, si las URLs apuntan al dominio correcto, si hay permisos adecuados, si faltan miniaturas y si la caché o el CDN están mostrando rutas antiguas.

¿Puedo migrar solo una parte de la biblioteca de medios?

Sí. Puedes mover solo ciertas carpetas, rangos de fechas o tipos de archivo, pero hay que comprobar después que WordPress los reconoce y que las URLs son correctas.

¿WP-CLI sirve para importar imágenes a WordPress?

Sí. WP-CLI permite importar archivos como adjuntos de la biblioteca de medios mediante comandos como wp media import. Es una opción útil para usuarios técnicos con acceso al servidor.

¿Qué plugin puedo usar para registrar archivos que ya están en uploads?

Plugins como Media Sync pueden ayudar a detectar archivos subidos al servidor y registrarlos en la biblioteca de medios. Antes de usarlos conviene hacer copia de seguridad.

¿Qué pasa con las imágenes destacadas al migrar?

Las imágenes destacadas dependen de relaciones guardadas en la base de datos. Si se pierden registros o IDs durante la migración, las entradas, páginas o productos pueden quedarse sin imagen destacada.

¿Hay que cambiar URLs al migrar imágenes de WordPress?

Si cambia el dominio o la ruta, probablemente sí. Puede ser necesario reemplazar URLs antiguas por nuevas en la base de datos, siempre con copia previa.

¿ideaWeb puede reparar una biblioteca de medios rota?

Sí. En ideaWeb podemos revisar archivos, biblioteca de medios, URLs, base de datos, imágenes destacadas, permisos y errores derivados de una migración WordPress mal hecha.