Initial release of Broken Media Inspector.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3622086,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3622086,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3622086,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3622086,"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":3622086,"resolution":"1","location":"assets","locale":"","width":2515,"height":1466},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3622086,"resolution":"2","location":"assets","locale":"","width":2520,"height":1602},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3622086,"resolution":"3","location":"assets","locale":"","width":2520,"height":1568},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3622086,"resolution":"4","location":"assets","locale":"","width":2520,"height":1566}},"screenshots":{"1":"Every missing file with its likely cause, a suggested fix, and edit links to each post that uses it","2":"Orphaned Files tab \u2014 unregistered files in wp-content\/uploads with Add to Library \/ Archive actions","3":"Archive tab \u2014 review archived files, then Restore or permanently delete to reclaim space","4":"Scanning the Media Library, with live progress you can cancel at any time"}},"plugin_section":[],"plugin_tags":[14073,3786,163,84,267125],"plugin_category":[50],"plugin_contributors":[270694],"plugin_business_model":[],"class_list":["post-343624","plugin","type-plugin","status-publish","hentry","plugin_tags-broken","plugin_tags-cleanup","plugin_tags-images","plugin_tags-media","plugin_tags-orphaned","plugin_category-media","plugin_contributors-fraew","plugin_committers-fraew"],"banners":{"banner":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/banner-772x250.png?rev=3622086","banner_2x":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/banner-1544x500.png?rev=3622086","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/icon-128x128.png?rev=3622086","icon_2x":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/icon-256x256.png?rev=3622086","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/screenshot-1.png?rev=3622086","caption":"Every missing file with its likely cause, a suggested fix, and edit links to each post that uses it"},{"src":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/screenshot-2.png?rev=3622086","caption":"Orphaned Files tab \u2014 unregistered files in wp-content\/uploads with Add to Library \/ Archive actions"},{"src":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/screenshot-3.png?rev=3622086","caption":"Archive tab \u2014 review archived files, then Restore or permanently delete to reclaim space"},{"src":"https:\/\/ps.w.org\/fraew-broken-media-inspector\/assets\/screenshot-4.png?rev=3622086","caption":"Scanning the Media Library, with live progress you can cancel at any time"}],"raw_content":"\n
Broken Media Inspector is a fast, free media-maintenance tool for WordPress. It does two jobs exceptionally well \u2014 and unlike many alternatives, there is no paid tier, no row limit, and no external service.<\/p>\n\n
After a migration, backup restore, or hosting change, images go missing. Broken Media Inspector scans every item in your Media Library and tells you:<\/p>\n\n
Missing files are grouped by folder<\/strong>, so a whole missing directory shows up as a single line instead of hundreds \u2014 the fastest way to spot a migration that dropped a folder. Results export to CSV.<\/p>\n\n The scan runs in two phases: a fast pass that checks every file on disk, then a background pass that works out usage only for the broken items. Thousands of images scan in seconds.<\/p>\n\n Over time your Archiving is a safe, reversible cleanup. Nothing is deleted straight away: you archive the files you think you don't need, check your site still looks right, and only then empty the archive. Changed your mind about a file? Restore it back to uploads in one click. This \"archive, verify, then delete\" workflow means you never lose a file you actually needed.<\/p>\n\n Generated thumbnails are recognised and never mistaken for orphans. Every file action is validated to stay inside your uploads folder and is limited to administrators.<\/p>\n\n The plugin lives at Tools > Broken Media Inspector and has three tabs.<\/p>\n\n Broken Media<\/strong><\/p>\n\n Orphaned Files<\/strong><\/p>\n\n Archive<\/strong><\/p>\n\n For support, documentation, and feature requests, visit:\nhttps:\/\/thebigcity.co.nz<\/p>\n\n This plugin is released under the GPLv2 or later license. See license.txt for full details.<\/p>\n\n Broken Media Inspector is developed by Christopher Andrews.\nhttps:\/\/thebigcity.co.nz<\/p>\n\n Built to help WordPress administrators diagnose broken media after migrations, backups and hosting changes \u2014 and safely clean up the stray files left behind. Free and unlimited. If it saves you time, you can support development at https:\/\/buymeacoffee.com\/fraew \u2615<\/p>\n\n\n Use it at your own risk, and always take a backup first. \"Orphaned\" only means a file is not registered in the Media Library \u2014 it does not<\/strong> guarantee the file is unused. Themes, page builders, sliders, custom code, and other plugins (including WebP and image-optimisation plugins) can reference files directly in ways WordPress cannot detect from its database. Treat the orphan list as a strong hint, not a certainty.<\/p>\n\n That is exactly why the plugin does not delete orphans outright. Instead you Archive<\/strong> them \u2014 they are moved to No. The broken-media scan is diagnostic \u2014 it tells you what's broken, where, and why, but restoring missing files is up to you (usually from a backup). This keeps it simple and safe.<\/p><\/dd>\n The broken-media scan is strictly read-only. The Orphaned Files tool can change things, but only when you ask it to. Archiving and restoring simply move files between The broken-media scan checks every file on disk in a fast first pass, so even large libraries finish quickly \u2014 typically a few seconds for a few thousand images, with usage details filled in afterwards.<\/p><\/dd>\n Yes. The broken-media scan only reads data. The orphan tools act only on the files you explicitly select.<\/p><\/dd>\n No. The orphan scanner builds a list of every file WordPress knows about \u2014 originals, scaled versions, and all generated thumbnail sizes \u2014 so legitimate thumbnails are never mistaken for orphans.<\/p><\/dd>\n No. Everything runs inside WordPress. No API calls, no cloud services, no data sent anywhere. Works on any hosting, including shared hosting.<\/p><\/dd>\n Yes. For each broken image, the report shows which pages\/posts reference it, with direct links to edit them.<\/p><\/dd>\n Yes. The plugin processes images in batches and tracks progress. Even massive libraries are supported.<\/p><\/dd>\n Congratulations! No action needed. The report shows detailed counts and can be exported as proof for your team or clients.<\/p><\/dd>\n The broken-media scan works alongside any optimisation, lazy-load or CDN plugin \u2014 it checks whether the real file exists on disk. Note that WebP\/optimiser plugins often create extra files (such as photo.jpg.webp) that aren't in the Media Library, so those will appear in the Orphaned Files list. They're usually in active use, so review before archiving.<\/p><\/dd>\n Version 1.0 supports single-site installations. Multisite is a candidate for a future release.<\/p><\/dd>\n Not in Version 1.0. Scheduled scanning is a candidate for a future release based on user feedback.<\/p><\/dd>\n The \"likely cause\" is a best guess based on the type of failure:<\/p>\n\n\ud83e\uddf9 Orphaned Files<\/h4>\n\n
wp-content\/uploads<\/code> folder collects files that are no longer in the Media Library \u2014 leftovers from deleted posts, failed imports, and manual uploads. Broken Media Inspector finds them, shows you how much space they take, and lets you either:<\/p>\n\n\n
wp-content\/uploads\/fbmi-archive<\/code><\/li>\n<\/ul>\n\nWhy choose this plugin<\/h4>\n\n
\n
Features<\/h3>\n\n
\n
Usage<\/h3>\n\n
\n
\n
\n
Support<\/h3>\n\n
License<\/h3>\n\n
Credits<\/h3>\n\n
\n
\/wp-content\/plugins\/<\/code><\/li>\n\n
Is the Orphaned Files feature safe? Any risk?<\/h3><\/dt>\n
wp-content\/uploads\/fbmi-archive<\/code>, so your site behaves as if they were gone, but you can Restore<\/strong> any file instantly if something breaks. Only empty the archive once you have confirmed everything still works.<\/p><\/dd>\nCan the plugin fix broken images automatically?<\/h3><\/dt>\n
Will this plugin modify my files or database?<\/h3><\/dt>\n
wp-content\/uploads<\/code> and wp-content\/uploads\/fbmi-archive<\/code>; permanent deletion happens only when you empty the archive. Every path is validated to stay inside the uploads folder.<\/p><\/dd>\nHow long does a scan take?<\/h3><\/dt>\n
Can I run this on a production site?<\/h3><\/dt>\n
Are generated thumbnails flagged as orphans?<\/h3><\/dt>\n
Does this plugin require any external services?<\/h3><\/dt>\n
Can I see which posts use a broken image?<\/h3><\/dt>\n
I have 10,000+ images. Can this handle it?<\/h3><\/dt>\n
What if all images check out as healthy?<\/h3><\/dt>\n
Does this work with image optimization or WebP plugins?<\/h3><\/dt>\n
Does this work with multisite?<\/h3><\/dt>\n
Can I schedule automatic scans?<\/h3><\/dt>\n
How do I interpret the \"likely cause\" suggestions?<\/h3><\/dt>\n
\n
1.0.0<\/h4>\n\n
\n