Media maintenance tools

  • tools
  • media
  • images
  • duplicates

Media tools manage image sizes, missing files, hashes, and duplicates. Open Dirigible → Tools & Maintenance. Overview: Using Tools & Maintenance.

Generate missing image sizes

Creates only registered sub-sizes that are missing. Safer than a full regenerate — existing sizes stay intact. Background auto-regen can also run after deploy; use this card for larger backlogs.

  1. Optionally enable any confirmations on the card.
  2. Scan to see how many images need work.
  3. Generate to process attachments (one per request; uses the page delay).

New sizes may also be optimized by EWWW when that plugin is active.

Delete unused image sizes

Removes generated sub-size files whose names are no longer registered (for example after a theme change). Originals and current sizes are kept.

  1. Scan first.
  2. Confirm the danger checkbox when shown.
  3. Delete only after you understand what will be removed — no undo.

Fix broken image references

Finds uploads image URLs whose files are missing (for example after deleting old sizes) and replaces them with the full original.

  1. Choose status filters on the card if offered.
  2. Preview matches.
  3. Apply when ready.

Missing media files

Finds library attachments whose files are gone from disk (any MIME type). Reports references and can optionally delete unreferenced attachment records.

  1. Scan (dry run).
  2. Review referenced vs unreferenced rows.
  3. Only use Delete missing after a database backup — permanent, and confirm when prompted.

Offload/CDN setups can produce false positives; trust local disk checks carefully on those hosts.

Index media hashes

Backfills content hashes on existing images so upload duplicate blocking and duplicate reports work. Writes hash meta only — detects byte-identical files, not similar-looking variants.

  1. Scan for unindexed images.
  2. Index hashes to process the backlog.

Hashing also runs in the background over time; this card finishes faster when you need it.

Find duplicate media

Reports groups of byte-identical attachments. Read-only — does not delete.

  1. Run Index media hashes first if coverage is incomplete.
  2. Run the duplicate report.
  3. Decide manually which copies to keep; nothing is removed for you.

Tips

  • Prefer Generate missing image sizes over deleting sizes unless you are sure old size names are obsolete.
  • After fixing library alt text, run Sync alt tags under Content gardening so blocks catch up — see Content gardening tools.
  • Format uploads well before they enter the library — Formatting images.