Title: Cleanup Orphan Images
Author: DimitriAus
Published: <strong>29 de diciembre de 2025</strong>
Last modified: 5 de septiembre de 2026

---

Buscar plugins

![](https://ps.w.org/cleanup-orphan-images/assets/banner-772x250.png?rev=3431993)

![](https://ps.w.org/cleanup-orphan-images/assets/icon-256x256.png?rev=3429958)

# Cleanup Orphan Images

 Por [DimitriAus](https://profiles.wordpress.org/dimitriaus/)

[Descargar](https://downloads.wordpress.org/plugin/cleanup-orphan-images.1.8.3.zip)

 * [Detalles](https://es.wordpress.org/plugins/cleanup-orphan-images/#description)
 * [Valoraciones](https://es.wordpress.org/plugins/cleanup-orphan-images/#reviews)
 *  [Instalación](https://es.wordpress.org/plugins/cleanup-orphan-images/#installation)
 * [Desarrollo](https://es.wordpress.org/plugins/cleanup-orphan-images/#developers)

 [Soporte](https://wordpress.org/support/plugin/cleanup-orphan-images/)

## Descripción

Finds and deletes redundant files from the uploads folders that are not visible 
in WordPress Media Library.

These orphan files may have been left behind from:

 * Failed or interrupted uploads
 * Plugin operations or migrations
 * FTP/SFTP uploads not registered in WordPress
 * Database restores or imports

#### Features

 * Scans uploads directory for orphan media files
 * Supports images: JPG, JPEG, PNG, GIF, WebP, BMP, TIFF, SVG, ICO
 * Supports documents: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODS, ODP, TXT,
   RTF, CSV
 * Supports audio: MP3, WAV, OGG, FLAC, AAC, M4A, WMA
 * Supports video: MP4, MOV, AVI, WMV, MKV, WebM, FLV, M4V, MPEG, MPG
 * Supports archives: ZIP, RAR, 7Z, TAR, GZ
 * Safe manual selection before deletion
 * Warns when orphan count exceeds server’s max_input_vars limit (typically 1000)
 * Optimized O(1) performance with hash-based detection

#### Note

This plugin does NOT manage «unattached» images in the Media Library. WordPress 
already provides built-in filtering for unattached media.

## Instalación

 1. Upload the `cleanup-orphan-images` folder to `/wp-content/plugins/`
 2. Activate through the ‘Plugins’ menu
 3. Go to Media > Cleanup Orphan Images

## FAQ

### What are orphan files?

Orphan files are physical media files in your uploads folder that exist on the server
but are not registered in the WordPress database.

### Is it safe to delete orphan files?

Review the list before deletion. Some files may still be used by themes or plugins
that reference them directly by URL. Always back up your uploads folder first.

### Can I recover deleted files?

No, deletion is permanent. Back up your site first.

### Interaction with other plugins

Some hosting providers and image optimisation plugins (such as Imagify or ShortPixel)
auto-generate `.webp` versions of images using Nginx/Apache rewrite rules and store
them in the uploads folder without registering them in WordPress.

Server-side rewrite rules is not part of the official WordPress media management
specification and is not endorsed by WordPress. This plugin follows the WordPress
standard — if a file is not registered in the WordPress database, it is an orphan.
Any files created outside of that standard by third-party tools or hosting configurations
are beyond the scope and responsibility of this plugin.

If you see unexpected files in the scan results, do not select them for deletion
unless you are absolutely sure they are not used.

For image optimisation, the workaround is to disable server-side rewriting plugins
and switch to a WordPress-native WebP converter (such as [Manly WebP Converter](https://wordpress.org/plugins/manly-webp-converter/))
which significantly reduces file sizes and registers converted files properly in
the database — after which those files will never appear as orphans.

## Reseñas

![](https://secure.gravatar.com/avatar/b7c2afcc4c8d89a2dd19ebe74af2b2f2b9938aca8ba997f650b638d32876c1ad?
s=60&d=retro&r=g)

### 󠀁[Wonderful !](https://wordpress.org/support/topic/wonderful-1119/)󠁿

 [clementmartineau](https://profiles.wordpress.org/clementmartineau/) 4 de septiembre
de 2026 1 respuesta

Only 1 review and a hundred installations ? I had to participate ! I was wondering
why my media backups were so heavy, and I discovered the existence of orphan medias..
So I tried this plugin, it can't be more simple to use than that, scan, delete, 
end. And it worked perfectly, no broken images on website, only orphan medias deleted.
For a client's website that I have taken over managing, the media backups went from
over 480Mo to 60Mo. Simply lovely.

![](https://secure.gravatar.com/avatar/f419ba0b5104ee7b9ea0e3be73501958568e387404f34d636376d8a14a6942d1?
s=60&d=retro&r=g)

### 󠀁[Lightweight and delivering, It just works.](https://wordpress.org/support/topic/lightweight-and-delivering-it-just-works/)󠁿

 [walstice](https://profiles.wordpress.org/walstice/) 30 de diciembre de 2025 1 
respuesta

11.4 kb for a plugin is admirable, thank you

 [ Leer todas las 2 reseñas ](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/)

## Colaboradores y desarrolladores

«Cleanup Orphan Images» es un software de código abierto. Las siguientes personas
han colaborado con este plugin.

Colaboradores

 *   [ DimitriAus ](https://profiles.wordpress.org/dimitriaus/)

[Traduce «Cleanup Orphan Images» a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/cleanup-orphan-images)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/cleanup-orphan-images/),
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/cleanup-orphan-images/)
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/cleanup-orphan-images/)
por [RSS](https://plugins.trac.wordpress.org/log/cleanup-orphan-images/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 1.8.3

 * Fixed: Media files could be incorrectly reported and deleted as orphans on Windows
   environments due to a path slash mismatch.
 * Fixed: Duplicate copies of registered files outside their registered folder are
   now correctly detected.
 * Added: Scan results are now capped at 1000 files per batch to prevent the admin
   page from hanging on very large uploads folders.
 * Added: Scanned folder path is now displayed on the scan page.
 * Cleanup unused js and handlers.

#### 1.8.2

 * Updated: Tested up to WordPress 7.1.

#### 1.8.1

 * Added FAQ entry explaining interaction with server-side WebP rewriting plugins

#### 1.8.0

 * Simplified plugin to focus on orphan files only
 * Removed unattached images feature (use WordPress built-in Media Library filter
   instead)
 * Expanded file format support: images, documents, audio, video, archives
 * Cleaner, more focused user interface

#### 1.7.2

 * Minor GUI fix

#### 1.7.1

 * Removed broken automated batch deletion button

#### 1.7.0

 * Full PHPCS/WPCS coding standards compliance
 * Performance optimization for orphan file scanning
 * Security improvements with capability checks

#### 1.6.0

 * WordPress.org compliance improvements
 * Enhanced security and caching

#### 1.5.0

 * Added orphan files detection
 * Batch processing with progress tracking

#### 1.0.0

 * Initial release

## Meta

 *  Versión **1.8.3**
 *  Última actualización **hace 1 mes**
 *  Instalaciones activas **100+**
 *  Versión de WordPress ** 5.0 o superior **
 *  Probado hasta **7.1.3**
 *  Versión de PHP ** 7.4 o superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/cleanup-orphan-images/)
 * Etiquetas:
 * [cleanup](https://es.wordpress.org/plugins/tags/cleanup/)[files](https://es.wordpress.org/plugins/tags/files/)
   [images](https://es.wordpress.org/plugins/tags/images/)[media](https://es.wordpress.org/plugins/tags/media/)
   [orphan](https://es.wordpress.org/plugins/tags/orphan/)
 *  [Vista avanzada](https://es.wordpress.org/plugins/cleanup-orphan-images/advanced/)

## Valoraciones

 5 de 5 estrellas.

 *  [  2 valoraciones de 5 estrellas     ](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/?filter=5)
 *  [  0 valoraciones de 4 estrellas     ](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/?filter=4)
 *  [  0 valoraciones de 3 estrellas     ](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/?filter=3)
 *  [  0 valoraciones de 2 estrellas     ](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/?filter=2)
 *  [  0 valoraciones de 1 estrellas     ](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/?filter=1)

[Tu valoración](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/#new-post)

[Ver todas las reseñas](https://wordpress.org/support/plugin/cleanup-orphan-images/reviews/)

## Colaboradores

 *   [ DimitriAus ](https://profiles.wordpress.org/dimitriaus/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/cleanup-orphan-images/)