{"id":338701,"date":"2026-07-11T18:48:41","date_gmt":"2026-07-11T18:48:41","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/tidy-images-used-unused-image-cleaner\/"},"modified":"2026-07-11T18:53:23","modified_gmt":"2026-07-11T18:53:23","slug":"tidy-images","status":"publish","type":"plugin","link":"https:\/\/scn.wordpress.org\/plugins\/tidy-images\/","author":23519690,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0.1","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Tidy Images \u2013 Used & Unused Image Cleaner","header_author":"Pushpasharmila S","header_description":"Find used and unused images in WordPress, see where images are used, and safely clean unnecessary media files.","assets_banners_color":"e7e2cc","last_updated":"2026-07-11 18:53:23","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":50,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"pushpasharmila26","date":"2026-07-11 18:53:23"}},"upgrade_notice":{"1.0.0":"<p>Initial release of Tidy Images \u2013 Used &amp; Unused Image Cleaner.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3604240,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3604240,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3604240,"resolution":"1","location":"assets","locale":"","width":1690,"height":932},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3604240,"resolution":"2","location":"assets","locale":"","width":1690,"height":929}},"screenshots":{"1":"Tidy Images admin screen with Used Images and Unused Images sections.","2":"Used Images section showing where images are being used.","3":"Unused Images section with single and bulk permanent deletion options.","4":"Image usage details showing multiple detected locations."}},"plugin_section":[],"plugin_tags":[227565,253777,233,146945],"plugin_category":[],"plugin_contributors":[271114],"plugin_business_model":[],"class_list":["post-338701","plugin","type-plugin","status-publish","hentry","plugin_tags-media-cleaner","plugin_tags-media-cleanup","plugin_tags-media-library","plugin_tags-unused-images","plugin_contributors-pushpasharmila26","plugin_committers-pushpasharmila26"],"banners":{"banner":"https:\/\/ps.w.org\/tidy-images\/assets\/banner-772x250.png?rev=3604240","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/tidy-images\/assets\/icon-256x256.png?rev=3604240","icon_2x":"https:\/\/ps.w.org\/tidy-images\/assets\/icon-256x256.png?rev=3604240","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/tidy-images\/assets\/screenshot-1.png?rev=3604240","caption":"Tidy Images admin screen with Used Images and Unused Images sections."},{"src":"https:\/\/ps.w.org\/tidy-images\/assets\/screenshot-2.png?rev=3604240","caption":"Used Images section showing where images are being used."}],"raw_content":"<!--section=description-->\n<p>Tidy Images is a lightweight WordPress media cleanup plugin that helps you identify used and unused images in your Media Library.<\/p>\n\n<p>Instead of simply marking an image as used, Tidy Images also shows where the image is being used. This helps you understand your media usage before permanently deleting unnecessary files.<\/p>\n\n<p>The plugin is designed to be simple, transparent, and easy to manage without adding unnecessary features.<\/p>\n\n<h4>Used and Unused Image Detection<\/h4>\n\n<p>Tidy Images scans your Media Library and separates images into two clear sections:<\/p>\n\n<ul>\n<li>Used Images<\/li>\n<li>Unused Images<\/li>\n<\/ul>\n\n<p>This makes it easier to review your media files and identify images that may no longer be needed.<\/p>\n\n<h4>See Where Images Are Used<\/h4>\n\n<p>For each used image, the plugin displays where the image was detected.<\/p>\n\n<p>Usage information can include:<\/p>\n\n<ul>\n<li>Posts<\/li>\n<li>Pages<\/li>\n<li>Custom post types<\/li>\n<li>Featured images<\/li>\n<li>Post content<\/li>\n<li>Custom image fields<\/li>\n<li>Gutenberg content<\/li>\n<li>Elementor content<\/li>\n<li>WooCommerce products<\/li>\n<\/ul>\n\n<p>If the same image is used in multiple locations, Tidy Images displays the different usage locations.<\/p>\n\n<h4>WordPress Content Support<\/h4>\n\n<p>Tidy Images can detect images used in:<\/p>\n\n<ul>\n<li>Posts<\/li>\n<li>Pages<\/li>\n<li>Public custom post types<\/li>\n<li>Featured images<\/li>\n<li>Post content<\/li>\n<li>Custom fields<\/li>\n<li>Gutenberg blocks<\/li>\n<li>Elementor content<\/li>\n<\/ul>\n\n<h4>WooCommerce Support<\/h4>\n\n<p>When WooCommerce is active, Tidy Images can detect and protect images used as:<\/p>\n\n<ul>\n<li>Product featured images<\/li>\n<li>Product gallery images<\/li>\n<li>Product variation images<\/li>\n<li>WooCommerce placeholder images<\/li>\n<\/ul>\n\n<p>The WooCommerce placeholder image is treated as a used image to help prevent accidental deletion.<\/p>\n\n<h4>Important Image Protection<\/h4>\n\n<p>Tidy Images protects important WordPress images from being marked as unused, including:<\/p>\n\n<ul>\n<li>Site Icon<\/li>\n<li>Custom Logo<\/li>\n<li>WooCommerce Placeholder Image<\/li>\n<\/ul>\n\n<h4>Safe Review Before Deletion<\/h4>\n\n<p>Unused images are displayed separately so you can review them before deletion.<\/p>\n\n<p>You can:<\/p>\n\n<ul>\n<li>Delete a single unused image<\/li>\n<li>Select multiple unused images<\/li>\n<li>Select all unused images on the current page<\/li>\n<li>Permanently delete selected images<\/li>\n<\/ul>\n\n<p>A confirmation message is shown before permanent deletion.<\/p>\n\n<h4>Pagination<\/h4>\n\n<p>Used and unused images are displayed with separate pagination.<\/p>\n\n<p>This makes larger Media Libraries easier to browse and manage.<\/p>\n\n<h4>Lightweight and Focused<\/h4>\n\n<p>Tidy Images focuses on one main purpose: helping you understand which images are used and which images may be safely reviewed for cleanup.<\/p>\n\n<p>The plugin does not try to replace image optimization, compression, or CDN plugins.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>tidy-images<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory, or install the plugin through the WordPress Plugins screen.<\/li>\n<li>Activate Tidy Images through the Plugins screen in WordPress.<\/li>\n<li>Open <code>Tidy Images<\/code> from the WordPress admin menu.<\/li>\n<li>Review the Used Images and Unused Images sections.<\/li>\n<li>Check image usage information before permanently deleting any image.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20tidy%20images%20automatically%20delete%20unused%20images%3F\"><h3>Does Tidy Images automatically delete unused images?<\/h3><\/dt>\n<dd><p>No. Tidy Images does not automatically delete images.<\/p>\n\n<p>You must manually review and confirm images before permanent deletion.<\/p><\/dd>\n<dt id=\"can%20i%20see%20where%20an%20image%20is%20being%20used%3F\"><h3>Can I see where an image is being used?<\/h3><\/dt>\n<dd><p>Yes. Used images display the detected usage location, such as a post, page, custom post type, featured image, content area, custom field, or supported WooCommerce location.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20support%20custom%20post%20types%3F\"><h3>Does the plugin support custom post types?<\/h3><\/dt>\n<dd><p>Yes. Tidy Images scans public custom post types and can detect featured images, content images, and supported custom image field values.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20support%20gutenberg%3F\"><h3>Does the plugin support Gutenberg?<\/h3><\/dt>\n<dd><p>Yes. Tidy Images can detect images used in supported Gutenberg content.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20support%20elementor%3F\"><h3>Does the plugin support Elementor?<\/h3><\/dt>\n<dd><p>Yes. Tidy Images can detect supported image references stored in Elementor content.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20support%20woocommerce%3F\"><h3>Does the plugin support WooCommerce?<\/h3><\/dt>\n<dd><p>Yes. When WooCommerce is active, the plugin can detect product featured images, gallery images, variation images, and the WooCommerce placeholder image.<\/p><\/dd>\n<dt id=\"are%20the%20site%20icon%20and%20custom%20logo%20protected%3F\"><h3>Are the Site Icon and Custom Logo protected?<\/h3><\/dt>\n<dd><p>Yes. The WordPress Site Icon and Custom Logo are treated as used images.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20i%20permanently%20delete%20an%20image%3F\"><h3>What happens when I permanently delete an image?<\/h3><\/dt>\n<dd><p>The original image and its generated image sizes are permanently removed using WordPress attachment deletion functionality.<\/p>\n\n<p>Permanent deletion cannot be undone. Always review images before deleting them and keep a recent website backup.<\/p><\/dd>\n<dt id=\"can%20i%20delete%20multiple%20images%20at%20once%3F\"><h3>Can I delete multiple images at once?<\/h3><\/dt>\n<dd><p>Yes. The Unused Images section supports selecting multiple images and permanently deleting the selected files after confirmation.<\/p><\/dd>\n<dt id=\"why%20is%20an%20image%20marked%20as%20used%20even%20if%20i%20cannot%20see%20it%20on%20the%20front%20end%3F\"><h3>Why is an image marked as used even if I cannot see it on the front end?<\/h3><\/dt>\n<dd><p>An image may still be referenced by content, a custom field, a page builder, a draft or private post, a WooCommerce product, or another supported location.<\/p>\n\n<p>Review the usage information before deleting any image.<\/p><\/dd>\n<dt id=\"can%20every%20dynamically%20loaded%20image%20be%20detected%3F\"><h3>Can every dynamically loaded image be detected?<\/h3><\/dt>\n<dd><p>No image cleanup plugin can guarantee detection of every possible dynamically generated or custom-coded image reference.<\/p>\n\n<p>Themes, plugins, custom code, external storage, CSS files, JavaScript, and unsupported data structures may reference images in ways that are not detectable by Tidy Images.<\/p>\n\n<p>Always review unused images and keep a recent backup before permanent deletion.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Added used and unused image detection.<\/li>\n<li>Added image usage location tracking.<\/li>\n<li>Added support for posts and pages.<\/li>\n<li>Added support for public custom post types.<\/li>\n<li>Added featured image detection.<\/li>\n<li>Added content image detection.<\/li>\n<li>Added custom image field detection.<\/li>\n<li>Added Gutenberg content detection.<\/li>\n<li>Added Elementor content detection.<\/li>\n<li>Added WooCommerce product image detection.<\/li>\n<li>Added WooCommerce gallery image detection.<\/li>\n<li>Added WooCommerce variation image detection.<\/li>\n<li>Added WooCommerce placeholder image protection.<\/li>\n<li>Added WordPress Site Icon protection.<\/li>\n<li>Added WordPress Custom Logo protection.<\/li>\n<li>Added separate pagination for used and unused images.<\/li>\n<li>Added single permanent image deletion.<\/li>\n<li>Added bulk permanent image deletion.<\/li>\n<li>Added confirmation before permanent deletion.<\/li>\n<li>Added nonce verification and user capability checks.<\/li>\n<\/ul>","raw_excerpt":"Find used and unused WordPress images, see exactly where images are used, and permanently remove unnecessary media files.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/338701","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=338701"}],"author":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/pushpasharmila26"}],"wp:attachment":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=338701"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=338701"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=338701"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=338701"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=338701"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=338701"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}