Skip to main content

7 - Used or not: the badges

Iris answers a tedious question: is this file still used anywhere? It looks for each file in the site's content and says so with a badge.

The badges

  • used: the file is referenced somewhere on the site.
  • unused: no usage found.
  • Trash (purple): the file is only referenced by trashed content. For the site it is no longer in use; Iris counts it with the unused files in filters and in the report.

Iris searches articles (text, intro and full images), categories, modules, menu items, custom fields, contacts, banners, tags, template settings, template files, Iris galleries, and SP Page Builder and Droptables if installed. An image used in a resized or WebP version counts for its original.

Show where

In a used file's details panel, the Show where button lists the places that reference it: Article "Home" #12, Module "Footer", Template file… with the state of each (trashed, unpublished, archived). Each line leads to the matching Joomla list, filtered on that item. It is the way to understand a "used" that seems unlikely.

In the Joomla media manager

Content → Media carries the same badges: a tick for used, a cross for unused, a purple trash can, and on each folder the number of used and unused files. The Unused files button, bottom right, gives the report: number of files, recoverable space, then the list.

Iris does not replace your judgement. It cannot see links from another site, images in an email already sent, or very unusual code. Check, and back up, before deleting.

Up to date for Iris 3.0.041.