Finding orphaned images in Joomla and cleaning up safely
After a few years, the media folder of a Joomla website is often full of images nobody needs any more. Old article images, photos in three sizes, drafts that never went online. That costs storage space, makes backups bigger and the overview worse.
Simply deleting them is still not a good idea. Here I show why, and how to do it properly.
Why so many files are left over
Joomla never deletes an image on its own. When you delete an article, replace an image or remove a module, the file stays in the folder. Joomla simply does not know whether it is still needed elsewhere.
On top of that come images that were uploaded twice and files from extensions that were uninstalled long ago.
Why you should not simply delete them
Under Content → Media you see your files, but not where they are used. An image can be used in many places:
- in the text of an article or as its intro or full article image
- in a category, a menu item or a module
- in a custom field
- in the template settings or in a CSS file
- in a page builder such as YOOtheme Pro or in another extension
If you delete an image that is still used somewhere, your visitors see a gap or a broken image icon. And often you only notice weeks later.
How to do it by hand
For a small website it works without tools, it just takes time.
- Make a backup first. Files and database, so you can go back if in doubt.
- Start small. Take one folder, not everything at once.
- Search for the file name. Most reliably in the database, for example with the search across all tables in phpMyAdmin. If the name does not appear anywhere, the image is a candidate, nothing more. Templates, CSS files and some extensions store paths outside the database.
- Move instead of deleting. Put the candidates into a separate folder outside
imagesinstead of deleting them straight away. - Watch for a few weeks. Under Components → Redirects, Joomla logs pages and files that were not found, as long as the Collect URLs option is switched on in the System - Redirect plugin. If one of your images shows up there, bring it back.
- Only then delete them for good.
On a website with hundreds of images, that is a project for several evenings.
Media Organizer makes it faster
I developed Media Organizer for exactly this task. It searches articles, categories, menus, modules, custom fields, the version history and the template, and shows for each file where it looked and with what result. Every place it finds comes with a direct link for editing.
Safety mattered most to me:
- A scan never changes anything in your files.
- Nothing is moved or deleted unless you have selected and confirmed it.
- The normal route is quarantine, which you can undo at any time.
- If Media Organizer does not know an installed extension well enough, it blocks permanent deletion.
The Free version costs nothing and covers all images that Joomla itself uses. The Pro version also knows extensions such as YOOtheme Pro, checks documents and videos too, and shrinks images that are too large.
This article is also available in German.

Related extension
A question about this topic, or an idea for the next guide? Write to me.
Norbert Graup
One membership: all Pro versions, updates and personal support.














