Drupal is a registered trademark of Dries Buytaert
cms 2.1.3 — Update released for Drupal core (2.1.3)! drupal 10.5.11 — Update released for Drupal core (10.5.11)! drupal 11.3.11 — Update released for Drupal core (11.3.11)! drupal 11.2.13 — Update released for Drupal core (11.2.13)! drupal 10.6.10 — Update released for Drupal core (10.6.10)! cms 2.1.2 — Update released for Drupal core (2.1.2)! drupal 11.1.10 — Update released for Drupal core (11.1.10)! drupal 10.5.10 — Update released for Drupal core (10.5.10)! drupal 10.4.10 — Update released for Drupal core (10.4.10)! drupal 11.2.12 — Update released for Drupal core (11.2.12)! drupal 11.3.10 — Update released for Drupal core (11.3.10)! drupal 10.6.9 — Update released for Drupal core (10.6.9)! drupal 10.6.8 — Update released for Drupal core (10.6.8)! drupal 11.3.9 — Update released for Drupal core (11.3.9)! drupal 11.3.8 — Update released for Drupal core (11.3.8)! drupal 11.3.7 — Update released for Drupal core (11.3.7)! drupal 11.2.11 — Update released for Drupal core (11.2.11)! drupal 10.6.7 — Update released for Drupal core (10.6.7)! drupal 10.5.9 — Update released for Drupal core (10.5.9)! cms 2.1.1 — Update released for Drupal core (2.1.1)!
← All modules

file_inspector

No security coverage
View on drupal.org

File Inspector finds the files your site forgot about. It scans your file system and identifies unmanaged files, files that exist on disk but are not referenced by any Drupal entity (no record in file_managed), then lets administrators review, delete, or import them into the Media library from a single report screen.

Over time, a Drupal site accumulates orphaned files: leftovers from deleted content, manual uploads, migrations, and third-party tooling. File Inspector gives you a clear, actionable inventory of what is actually on disk versus what Drupal knows about, and the tools to clean it up safely.

Key features

  • Orphaned file detection: classifies every discovered file as managed or unmanaged by checking it against Drupal's managed-file table.
  • Built for scale: uses generator-based iteration and the Batch API to handle large file systems (100k+ files) without exhausting memory.
  • Actionable report: a Views-based report with status, MIME-type, and date filters, per-row actions, and bulk operations.
  • Import into Media: turn an unmanaged file into a managed File + Media entity in one click (requires the core Media module).
  • Safe deletion: permanently remove orphaned files through confirmation forms, with path validation and permission gating.
  • Imported-media tracking: the report links each imported row directly to the Media item it produced, so every import is traceable.
  • Embedded web folder support: declare folders that hold embedded web apps (flipbooks, microsites). File Inspector records only their entry file and ignores the supporting assets, keeping them out of your deletion candidates.
  • Granular permissions: separate permissions for administering, viewing, deleting, and importing.

How it works

Inspection runs in two phases. First, File Inspector walks the configured stream wrapper(s) and records every file it finds. Then it classifies each record as managed or unmanaged by checking it against
file_managed. Results are stored in a dedicated table (not entities) for fast, scalable querying and full Views integration. When the Media module is absent, the module degrades gracefully: it still discovers, reports, and deletes files, and simply hides the import controls.

Requirements

  • Drupal core 11
  • Views (core)
  • Media (core) — optional

Activity

Total releases
1
First release
Jun 2026
Latest release
11 hours ago
Release cadence
—
Stability
0% stable

Releases

Version Type Release date
1.x-dev Dev Jun 5, 2026