clean_filename

[📄_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