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
Ask your assistant about Clean Filename
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
No dependencies recorded for this project.
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.