Una importación masiva de medios puede terminar sin errores y, aun así, dejar archivos fuera de la biblioteca, duplicados o inaccesibles. En WordPress, eso suele apuntar a un fallo de indexación, a una ruta de subida distinta o a permisos incorrectos, no a una pérdida definitiva.
Si tras una importación masiva los archivos “desaparecen” de la biblioteca de medios, normalmente no se han perdido: pueden estar en otra ruta, no haberse indexado, estar duplicados, corruptos o sin permisos correctos. La clave es revisar logs, validar la carpeta de subida, reindexar la librería y volver a enlazar los medios huérfanos antes de asumir una pérdida real.
Archivos no visibles: dónde mirar primero
Cuando un archivo no se ve en la librería de medios, el primer paso es separar archivo ausente de archivo no indexado. Ese matiz ahorra tiempo y evita duplicados.
La regla útil es simple: si el archivo existe en disco, no está perdido; está mal enlazado. Si no existe en disco, toca recuperar desde copia o volver a subirlo.
¿Está en la carpeta pero no en la librería?
Comprueba primero wp-content/uploads. Esa carpeta es el almacén físico, como un trastero lleno de cajas, y la librería de medios es solo el catálogo.
Haz esta revisión en orden:
- Entra por FTP o en el administrador de archivos del hosting.
- Busca el nombre exacto del archivo.
- Mira la fecha de subida y la subcarpeta usada.
- Compara esa ruta con la que WordPress muestra en los adjuntos.
¿Se importó sin crear el adjunto?
WordPress no muestra un archivo solo por existir en el servidor. Tiene que crear también su ficha, que es el registro que guarda nombre, ruta, fecha y relación con el contenido.
Un archivo visible en FTP, pero ausente en la biblioteca, suele indicar un fallo de indexado, no una pérdida real. Esa diferencia evita reimportar y multiplicar el problema.
Por qué faltan medios tras una importación masiva
La causa suele estar en una de cuatro fases: escritura del archivo, creación del adjunto, asociación con el contenido o generación de miniaturas. Si falla una sola, el resultado final queda roto.
Archivo omitido o duplicado
Un archivo omitido nunca llegó a registrarse. Un duplicado sí llegó, pero más de una vez.
Archivo corrupto o sin permisos
Un archivo corrupto existe, pero no se puede abrir bien. Los permisos también cortan el proceso y pueden dejar fuera medio lote sin aviso claro.
Ruta real y carpeta incorrecta
Si la ruta real no coincide con la esperada, el medio queda fuera del lugar que WordPress consulta por defecto.
Qué dicen los logs útiles
Los logs no cuentan historias bonitas, pero sí dicen dónde se rompió el proceso. Busca avisos de tiempo agotado, memoria insuficiente, permisos denegados y fallos de lectura de archivo.
No todos los casos son iguales cuando un lote “desaparece” de la librería de medios. Un archivo omitido nunca llegó a registrarse; un duplicado sí existe, pero se ha subido más de una vez; un archivo corrupto puede estar en wp-content/uploads pero no abrirse bien; y un medio importado en otra carpeta o ruta queda fuera del lugar que WordPress indexa por defecto. Por ejemplo, tras una importación masiva de 500 imágenes, puedes ver 470 archivos en la librería, 20 duplicados en subcarpetas distintas y 10 imágenes presentes en FTP pero sin adjunto creado.
Separar esos escenarios evita borrar contenido válido y ayuda a decidir si hay que reindexar, volver a enlazar o restaurar el original.
Checklist para auditar la importación sin duplicar nada
Antes de tocar nada, valida el lote entero. Esa revisión evita reimportar archivos ya subidos y llenar la biblioteca de medios con repetidos.
Qué comprobar en 10 minutos
Haz esta lista en el mismo orden. No saltes pasos.
- Confirma cuántos archivos debía traer el lote.
- Cuenta cuántos aparecen realmente en la biblioteca.
- Revisa si los faltantes están en
wp-content/uploads.
- Comprueba si el nombre cambia por acentos, espacios o símbolos raros.
- Mira si la fecha de subida coincide con el importador.
- Anota los que están duplicados o repetidos.
Qué logs revisar primero
Empieza por el log del importador, luego el del servidor y por último el de WordPress.
Matriz rápida: qué hacer según el caso
| Situación |
Acción correcta |
Riesgo si repites la importación |
| Archivo en disco, no en biblioteca |
Reindexar o volver a enlazar |
Duplicado y más trabajo |
| Archivo corrupto |
Sustituir el original |
Seguir arrastrando el fallo |
| Fallo de permisos |
Corregir permisos antes de subir |
La nueva carga volverá a fallar |
Señal de que ya puedes actuar
Si el archivo está localizable en uploads y el log no muestra corrupción, ya tienes una vía clara.
Cómo recuperar archivos huérfanos en WordPress
Si el archivo sigue en el servidor, hay recuperación posible.
Cuándo reindexar la librería
Reindexar sirve cuando el archivo existe, pero la biblioteca no lo ve. Pasa mucho tras importaciones grandes, migraciones y restauraciones parciales.
Cuándo regenerar miniaturas
La regeneración de miniaturas no recupera un archivo perdido. Solo recrea tamaños derivados, como la versión pequeña o la cuadrada.
Cómo volver a enlazar medios
La recuperación correcta sigue este orden:
- Localiza el archivo real en
wp-content/uploads.
- Comprueba que puede leerse por el servidor.
- Verifica que no tenga un nombre duplicado.
- Recréalo como adjunto o enlázalo de nuevo.
- Regenera miniaturas si la imagen las necesita.
- Revisa una página real donde se use ese medio.
Cuando restaurar desde copia
Si el archivo no está ni en uploads ni en una copia local, la restauración manda.
⚠️ Este procedimiento no arregla una importación que nunca llegó a ejecutarse, ni un problema limitado a miniaturas sin fallos en el archivo original, ni una incidencia de entradas, taxonomías o productos sin relación con medios.
Cuando el archivo sigue en el servidor pero no aparece en la librería de medios, la solución suele pasar por reindexar medios o volver a enlazar medios huérfanos, no por subirlo otra vez. Esto es especialmente útil tras migraciones, restauraciones parciales o importaciones hechas por FTP, donde el sistema puede dejar los archivos en wp-content/uploads sin crear el adjunto correspondiente. Si además hay miniaturas ausentes, conviene regenerarlas solo después de recuperar el adjunto original.
Y si los logs del servidor muestran errores de permisos o un archivo corrupto, primero se corrige la causa y luego se reintenta la indexación. Cuando no hay rastro local del medio, la copia de seguridad es la vía correcta para evitar pérdidas definitivas.
Permisos y copias que impiden repetir el fallo
Si el entorno sigue mal, el problema vuelve.
Qué permisos deben tener los archivos
La carpeta de subida necesita permitir lectura y escritura al usuario correcto del servidor.
Cómo influyen inodos y espacio
El disco puede tener espacio libre y, aun así, estar lleno de inodos.
Cuándo usar copia y restauración
La restauración tiene sentido cuando el fallo afecta a muchos medios o el importador dejó una mezcla de archivos buenos y rotos.
Qué hacer ahora con la importación fallida
La secuencia correcta es clara: localizar, auditar, reindexar, enlazar y, solo después, restaurar o reimportar.
Preguntas frecuentes
¿Qué errores se cometen al importar medios?
El error más común es repetir la subida sin revisar antes. También falla mucho no comprobar permisos, rutas y logs.
¿Cómo se arregla un archivo que no aparece?
Primero se localiza en disco. Luego se comprueba si WordPress lo registró como adjunto.
¿Qué significa un error genérico de importación?
Suele indicar que falló algo, pero el mensaje no dice qué.
¿Qué hago si el archivo está corrupto?
Se sustituye por una copia sana.
¿Sirve reimportar todo otra vez?
Solo si antes se ha confirmado que no hay adjuntos válidos ni archivos en disco.
¿Puede fallar solo una parte del lote?
Sí, y eso es muy habitual.
¿Qué papel tiene la copia de seguridad?
Es la red de seguridad real.
FAQ de apoyo para casos urgentes
¿Cuánto tarda la recuperación de medios?
Depende del volumen, pero un lote pequeño suele resolverse en menos de una hora.
¿Se pueden perder enlaces en páginas ya publicadas?
Sí, si se borra o cambia la ruta del archivo original.
¿Qué pasa si el medio está en otra carpeta?
Entonces no está perdido, está fuera de sitio.
