# openmage-image-cleaner | Fabrizio Balliano | Knowledge Base | Instagit

Image cleaner for Magento 1 and OpenMage. Cleans orphans category, product and wysiwyg images.

GitHub Stars: 21

Repository: https://github.com/fballiano/openmage-image-cleaner

---

## Articles

### [Does OpenMage Image Cleaner Handle the wysiwyg/swatches Folder for Configurable Swatches?](/fballiano/openmage-image-cleaner/does-openmage-image-cleaner-specifically-handle-the-wysiwygswatches-folder-for-configurable-swatches)

OpenMage Image Cleaner safely handles the media/wysiwyg/swatches folder for configurable swatches preventing accidental image deletion. Learn how.

- Tags: how-to-guide
- Published: 2026-03-01

### [How the `media_image` Frontend Input Drives Product Image Detection in OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/what-is-the-relationship-between-the-media_image-frontend_input-and-product-image-detection-in-the-cleaner)

Understand how OpenMage Image Cleaner's media_image frontend input detects product images. It automatically finds default and custom attributes, streamlining your image management.

- Tags: internals
- Published: 2026-03-01

### [How to Export Detected Orphan Images to CSV or Excel in OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/how-can-the-list-of-detected-orphan-images-be-exported-to-csv-or-excel-for-manual-review)

Export detected orphan images to CSV or Excel from OpenMage Image Cleaner admin grid. Download your list of unused images with one click for easy review.

- Tags: how-to-guide
- Published: 2026-03-01

### [What Does the Reset Action Do in OpenMage Image Cleaner? Does It Truncate the fb_imagecleaner_image Table?](/fballiano/openmage-image-cleaner/what-is-the-effect-of-the-reset-action-and-does-it-truncate-the-fb_imagecleaner_image-table)

Understand the OpenMage Image Cleaner reset action. This guide clarifies if the reset truncates the fb_imagecleaner_image table, ensuring you know its impact on your data.

- Tags: deep-dive
- Published: 2026-03-01

### [How the Mass Delete Action in OpenMage Image Cleaner Handles Missing Files Safely](/fballiano/openmage-image-cleaner/how-does-the-mass-delete-action-in-openmage-image-cleaner-handle-files-that-may-no-longer-exist-on-disk)

OpenMage Image Cleaner mass delete safely skips missing files with file_exists() and unlink() avoiding PHP warnings. Clean stale database records automatically.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Configure the Admin Grid Thumbnail Size and Enable Image Click-to-Zoom in OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/how-to-configure-the-admin-grid-thumbnail-size-and-enable-the-image-click-to-zoom-feature)

Learn how to configure OpenMage admin grid thumbnail size and enable image click to zoom for a better product image management experience. Easily adjust settings via System Configuration.

- Tags: how-to-guide
- Published: 2026-03-01

### [Why CSS Files in /skin/frontend Are Scanned for WYSIWYG Image Detection](/fballiano/openmage-image-cleaner/why-are-css-files-within-skinfrontend-directories-scanned-for-wysiwyg-image-detection)

Discover why the openmage-image-cleaner module scans CSS files in /skin/frontend to accurately detect WYSIWYG images and prevent accidental deletion of background images and icons.

- Tags: internals
- Published: 2026-03-01

### [How to Integrate OpenMage Image Cleaner with External Backup Systems Before Mass Deletions](/fballiano/openmage-image-cleaner/how-to-integrate-openmage-image-cleaner-with-external-backup-systems-before-performing-mass-deletions)

Secure your OpenMage Image Cleaner data. Learn how to integrate external backup systems before mass deletion for complete data protection and peace of mind.

- Tags: how-to-guide
- Published: 2026-03-01

### [Sync Product Cache vs Regular Product Sync in OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/what-is-the-difference-and-appropriate-use-case-between-sync-product-cache-and-regular-product-sync-actions)

Understand the OpenMage Sync Product Cache vs Regular Product Sync. Learn how to identify orphaned images and stale derivatives efficiently to clean your media storage.

- Tags: deep-dive
- Published: 2026-03-01

### [How OpenMage Image Cleaner Uses fnmatch for Blacklist Pattern Matching](/fballiano/openmage-image-cleaner/how-does-the-blacklist-pattern-matching-using-fnmatch-work-within-the-openmage-image-cleaner-module)

Discover how OpenMage Image Cleaner employs fnmatch for secure blacklist pattern matching. Learn how it protects your files from unwanted cleanup scans by matching glob patterns.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Add Custom Flush Actions to OpenMage Image Cleaner for Any Directory](/fballiano/openmage-image-cleaner/can-custom-flush-actions-be-added-to-openmage-image-cleaner-for-directories-other-than-mediatmp-or-varexport)

Unlock the power of OpenMage Image Cleaner by adding custom flush actions for any directory. Learn how to extend functionality beyond media tmp or var export for enhanced control.

- Tags: how-to-guide
- Published: 2026-03-01

### [Troubleshooting "It Was Not Possible to Delete One or More Files" in OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/troubleshooting-what-does-the-it-was-not-possible-to-delete-one-or-more-files-error-message-signify-in-the-cleaner)

Troubleshoot OpenMage Image Cleaner's 'It was not possible to delete one or more files' error. Learn common causes like permission issues, file locks, or path errors.

- Tags: troubleshooting
- Published: 2026-03-01

### [How OpenMage Image Cleaner Handles Magento Placeholder Images During Product Synchronization](/fballiano/openmage-image-cleaner/how-does-the-openmage-image-cleaner-interact-with-magentos-placeholder-image-configuration-during-product-synchronization)

Discover how OpenMage Image Cleaner protects Magento placeholder images during synchronization by excluding them from deletion and managing cache.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Extend OpenMage Image Cleaner to Detect Orphans in Custom Module Database Tables](/fballiano/openmage-image-cleaner/how-can-the-openmage-image-cleaner-be-extended-to-detect-orphans-in-custom-module-database-tables)

Extend OpenMage Image Cleaner to detect orphaned images in custom module database tables. Add a sync action to query custom tables and compare image paths against the filesystem.

- Tags: how-to-guide
- Published: 2026-03-01

### [Understanding entity_type_id Mapping in OpenMage Image Cleaner: Negative vs Positive Values](/fballiano/openmage-image-cleaner/understanding-entity_type_id-mapping-in-the-cleaner-when-are-negative-values-like-98-or-4-used-compared-to-positive-ones)

Learn how OpenMage Image Cleaner distinguishes real entities using positive entity_type_id values from synthetic flags like negative ones for cache thumbnails and WYSIWYG assets. Optimize your image cleanup.

- Tags: internals
- Published: 2026-03-01

### [How to Recover Accidentally Deleted Images After Using OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/how-to-recover-accidentally-deleted-images-after-using-the-openmage-image-cleaners-delete-functionality)

Accidentally deleted images with OpenMage Image Cleaner? Learn how to restore lost files by recovering from filesystem backups and re-inserting database records. Avoid data loss today.

- Tags: how-to-guide
- Published: 2026-03-01

### [Performance Considerations for Scanning Large Media Directories Using the scandirRecursive Helper Function](/fballiano/openmage-image-cleaner/performance-considerations-for-scanning-large-media-directories-using-the-scandirrecursive-helper-function)

Optimize large media directory scanning with scandirRecursive. Avoid RAM exhaustion, recursion limits, and timeouts in OpenMage Image Cleaner. Learn performance best practices.

- Tags: performance
- Published: 2026-03-01

### [OpenMage Image Cleaner Custom Product Image Attributes: Beyond the Default Media Gallery](/fballiano/openmage-image-cleaner/does-openmage-image-cleaner-support-custom-product-image-attributes-beyond-the-default-media-gallery)

OpenMage Image Cleaner automatically processes custom product image attributes beyond the default media gallery by querying EAV attributes with frontend_input='media_image'. Learn more.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Safely Delete Product Image Cache Using the OpenMage Image Cleaner Extension](/fballiano/openmage-image-cleaner/how-can-product-image-cache-be-safely-deleted-using-the-cleaner-extension-without-impacting-original-images)

Safely delete product image cache with OpenMage Image Cleaner. Purge stale cache files from media catalog product cache without touching original images. Keep your Magento store optimized.

- Tags: how-to-guide
- Published: 2026-03-01

### [Why Images Aren't Detected as Orphans by the OpenMage Image Cleaner: 7 Common Causes](/fballiano/openmage-image-cleaner/troubleshooting-why-might-images-not-be-detected-as-orphans-by-the-cleaner-even-if-they-appear-unused)

Discover 7 common reasons why OpenMage Image Cleaner might not detect orphan images. Learn about sync actions, blacklist patterns, placeholder protections, path mismatches, and more.

- Tags: troubleshooting
- Published: 2026-03-01

### [WYSIWYG Image Synchronization for CMS Content in OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/how-is-wysiwyg-image-synchronization-implemented-for-cms-blocks-pages-and-email-templates-in-openmage-image-cleaner)

Learn how OpenMage Image Cleaner syncs WYSIWYG images across CMS content by scanning media assets and cross-referencing them with pages blocks and templates to identify unused images for safe removal.

- Tags: how-to-guide
- Published: 2026-03-01

### [fb_imagecleaner_image Database Table Structure and entity_type_id Values in OpenMage Image Cleaner](/fballiano/openmage-image-cleaner/what-is-the-structure-of-the-fb_imagecleaner_image-database-table-and-what-do-entity_type_id-values-represent)

Explore the fb_imagecleaner_image database table structure in OpenMage Image Cleaner. Understand entity_type_id values for categories, products, cache, and WYSIWYG, and manage orphaned images effectively.

- Tags: api-reference
- Published: 2026-03-01

### [How to Configure Wildcard Blacklist Patterns in OpenMage Image Cleaner to Exclude Files or Folders](/fballiano/openmage-image-cleaner/how-to-configure-wildcard-blacklist-patterns-for-image-cleaner-to-exclude-files-or-folders)

Learn to configure wildcard blacklist patterns in OpenMage Image Cleaner. Exclude files or folders easily using glob wildcards in admin settings for efficient image management.

- Tags: how-to-guide
- Published: 2026-03-01

### [How OpenMage Image Cleaner Detects Orphan Category Images vs. Product Images](/fballiano/openmage-image-cleaner/how-does-openmage-image-cleaner-detect-orphan-category-images-versus-product-images)

Discover how OpenMage Image Cleaner distinguishes orphan category images from product images by analyzing database entries versus media files efficiently.

- Tags: how-to-guide
- Published: 2026-03-01