Clean Filename
Security covered
This module ensures that uploaded files always retain their original, clean filenames. Instead of renaming new uploads to avoid conflicts, it renames existing files with the same name to preserve the clean filename for the new upload, benefiting SEO and user experience.
[📄_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