clean_filename
Security covered
[📄_0] ➡️ [📄]
The Clean Filename module reverses Drupal's default file naming behavior to ensure new uploads always get clean, original filenames.
When a file with the same name as an existing file is uploaded, rather than the new file being given a suffix (like 0, _1), the existing file gets renamed while the clean name is preserved for the new upload.
How It Works:
Default Drupal Behavior:
- Existing: document.pdf
- New upload: document_0.pdf ❌
With Clean Filename Module:
- Existing: document.pdf → document_1.pdf (renamed)
- New upload: document.pdf ✅ (keeps clean name)
The Process:
- Drupal processes upload: Detects conflict and creates filename_0.ext
- Module detects rename: Recognizes Drupal added a suffix to the new file
- Smart renaming: Moves existing file to next available suffix
- Clean result: New file gets the original, clean filename
Key Benefits:
- Latest files have clean URLs - better for SEO and user experience
- Existing references preserved - old files keep their current URLs
- Per-field configuration - enable only where needed
- Intelligent suffix management - handles complex naming scenarios