Beskriuwing

Post Media Cleanup removes orphaned media files from your server when you permanently delete a post.

When you permanently delete a post, this plugin automatically finds and removes:

Featured image
Images and files embedded in post content
PDFs and any linked files in content
All attachments uploaded directly to the post

Key Features

Only fires on permanent deletion — moving to trash is always safe
Skip Shared Media — never deletes a file used by another post
Works per post type — configure exactly which types trigger cleanup
Compatible with S3 and cloud storage
Multisite ready
Developer friendly — filter hooks to extend behaviour

For Developers

Add extra attachments to the deletion list:

add_filter( 'postmediaweb_attachment_ids_to_delete', function( $ids, $post_id ) {
    $extra = get_post_meta( $post_id, 'my_custom_pdf', true );
    if ( $extra ) $ids[] = (int) $extra;
    return $ids;
}, 10, 2 );

Prevent a specific attachment from being deleted:

add_filter( 'postmediaweb_should_delete_attachment', function( $should, $att_id, $post_id ) {
    if ( $att_id === 999 ) return false;
    return $should;
}, 10, 3 );

Ynstallaasje

Upload the plugin folder to /wp-content/plugins/
Activate through the Plugins screen
Go to Settings Post Media Cleanup to configure

FAQ

Does it delete media when I move a post to trash?: No. Only permanent deletion triggers cleanup. Trash is always safe.
What if the same image is used in two posts?: With Skip Shared Media enabled (default), the plugin checks before deleting. If the file is used elsewhere it is preserved.
Does it work with WooCommerce products?: Yes. Enable Products in the Post Types setting.
Does it work with S3 or cloud storage?: Yes. It uses wp_delete_attachment() which cloud storage plugins hook into automatically.

Resinsjes

D’r binne gjin resinsjes foar dizze plugin.

Meiwurkers & amp; Untwikkelders

“Post Media Cleanup” is iepen boarne software. De folgjende minsken hawwe bydroegen oan dizze plugin.

iftiarhossain

Oersette “Post Media Cleanup” yn jo taal.

Ynteressearre yn ûntwikkeling?

Blêdzje troch de koade , besjoch de SVN-repository , of abonnearje op it ûntwikkelingslogboek troch RSS .

Feroaringslog

2.4.0

Fixed (data loss): Elementor images inside repeaters (slides, tabs, icon lists, nested containers) were not recognised as “in use”, so a shared image could be deleted. Media controls are now found at any depth.
Fixed (data loss): images referenced from CSS url(...), or after a domain change / http-https mix / CDN or S3 URL, were not recognised as “in use”. Usage is now matched by upload-relative path, independent of host.
Fixed (data loss): the Bulk Orphan Cleanup flagged files used by widgets, theme mods, menus, page-builder meta, user meta and ACF fields on terms/users/options pages. These are now checked.
Fixed (data loss): the scanner flagged media belonging to posts in the Trash, so restoring a post could lose its images. Only attachments with no existing parent are now reported, and trashed posts count as references.
Fixed (data loss): a “scaled” image’s original file, and WebP/AVIF siblings, are now treated as the same media.
Fixed: unchecking every post type silently re-enabled “post”; “none selected” now really deletes nothing.
Fixed: fatal error on WordPress 5.0 – 5.4 when deleting a post (hook argument added in 5.5).
Fixed: a failure inside the plugin could block a post from being deleted; errors are now contained.
Fixed: fatal error on hosts without the PHP DOM extension.
Fixed: bulk delete sent every ID in one request and was truncated by max_input_vars; it now runs in batches with a progress bar.
Fixed: the post-type warning script was never loaded; the admin CSS depended on an unreliable style handle; the delete button label was built by string-replacing a translatable string.
Fixed: the WooCommerce setting was reset to “off” on each save while WooCommerce was inactive.
Fixed: ACF repeater / flexible content / group handling now reads stored references (any nesting depth) instead of altering ACF’s global loop state.
Fixed: libxml error handling is restored after parsing; video, audio, source, embed, object and iframe uploads are now collected from content.
Security: a logged-in user can only trigger deletion of media they are allowed to delete (filter postmediaweb_enforce_capabilities).
Security: bulk delete re-validates on the server that each ID is an attachment, still an orphan, still unreferenced and deletable by the user.
Security: hardened AJAX input handling (nested arrays no longer become ID 1, request size capped, wp_unslash applied).
Security: results of the postmediaweb_attachment_ids_to_delete filter are validated; index.php guards added.
Performance: ACF, Elementor, WooCommerce-gallery and content checks use narrow, targeted SQL instead of loading every row that contains a digit.

2.3.1

Fixed: shared product-description images are preserved when content uses a resized image URL.
Fixed: a product’s own variation-image references no longer prevent those variation images from being cleaned up.
Fixed: variation images are collected even when the variations have already been moved to the trash.

2.3.0

Added WooCommerce product gallery image collection on product delete
Added WooCommerce product variation image deletion
Added short description media scanning for all post types
Added dedicated WooCommerce settings section (visible only when WooCommerce is active)
Improved post type selector UI with Built-in vs Custom grouping
Added post type descriptions for known third party types
Added warning when no post types are selected

2.2.0

Fixed: an image shared across multiple WooCommerce product galleries (_product_image_gallery) was deleted when only one of those products was removed, even though other products still used it.
Fixed: an image referenced only inside Elementor content/templates (_elementor_data) was deleted once its original post was removed, even though Elementor still referenced it elsewhere.
Fixed: “Skip Shared Media” only ever checked the featured-image meta and a literal URL match in post content — it now also checks WooCommerce product galleries, Elementor data, ACF image/file/gallery fields (including repeater and flexible-content sub-fields), term meta (e.g. category thumbnails), Gutenberg image/gallery blocks, [gallery ids="..."] and WPBakery shortcodes, and known media-holding site options (custom logo, site icon).
Fixed: the Bulk Orphan Cleanup scanner used the same narrow “featured image + literal URL” check and could flag genuinely-used media as orphaned for all the reasons above.
Changed: media-reference detection is conservative by design — a bare numeric value that happens to match an attachment ID (e.g. a generic custom field) is never treated as a confirmed reference on its own; only meta keys/structures positively identified as media storage (WooCommerce, Elementor, ACF field definitions, etc.) count.
Added: the Bulk Orphan Cleanup deletion step now re-checks each attachment immediately before deleting it, instead of trusting the scan result alone — anything found to have become referenced since the scan (e.g. the site changed while a large scan was running) is skipped rather than deleted, and the admin UI now reports how many were skipped for this reason.
Added: media-reference detection is now shared between the real-time “Skip Shared Media” check and the Bulk Orphan Cleanup scanner (Postmediaweb_Reference_Checker), so the two can no longer disagree with each other.

2.1.0

Fixed: deleting a post with a populated ACF gallery field could crash with a fatal error on PHP 8+ (missing return value in the gallery field handler).
Fixed: the Settings tab could not save changes due to a settings-group name mismatch.
Fixed: the Bulk Orphan Cleanup tab’s Scan/Delete buttons had no JavaScript attached and did nothing, because jQuery was never enqueued on that page.
Fixed: reactivating the plugin silently reset your saved settings back to defaults.
Fixed: the orphan scanner could exhaust available memory on large sites by loading all post content and all attachment records into memory at once.
Fixed: the orphan scanner’s content-matching was far slower than intended at scale; it now uses a single indexed pass instead of a full-text scan per attachment.
Fixed: attachments whose parent post no longer exists were permanently hidden from orphan scans instead of being correctly flagged.
Fixed: a PHP notice could be triggered by certain Elementor widget settings during media detection.
Improved: fewer database queries when scanning ACF fields on each deleted post.

2.0.0

Added ACF Free and Pro support
Added Bulk Orphan Cleanup tool with progress indicator
Added tabbed settings interface

1.0.0

Initial release

Beskriuwing

Key Features

For Developers

Ynstallaasje

FAQ

Does it delete media when I move a post to trash?

What if the same image is used in two posts?

Does it work with WooCommerce products?

Does it work with S3 or cloud storage?